home *** CD-ROM | disk | FTP | other *** search
| MacBinary | 1995-04-20 | 562.0 KB | [ONLN/HLX2] |
open in: 
MacOS 8.1
|
Win98
|
DOS
browse contents |
view JSON data
|
view as text
This file was processed as: MacBinary
(archive/macBinary).
| Confidence | Program | Detection | Match Type | Support
|
|---|
| 1%
| dexvert
| MacBinary (archive/macBinary)
| fallback
| Supported |
| 100%
| file
| MacBinary II, inited, Thu Apr 20 14:13:09 1995, modified Thu Apr 20 14:53:32 1995, creator 'HLX2', type 'ONLN', 571831 bytes "Implementing Multipane Dialogs" , at 0x8ba37 3420 bytes resource
| default (weak)
| |
| 99%
| file
| data
| default
| |
| 100%
| TrID
| MacBinary 2
| default (weak)
| |
| 100%
| dearkID
| deark: macbinary
| default
| |
| 100%
| siegfried
| fmt/1762 MacBinary (II)
| default
| |
| 100%
| lsar
| MacBinary
| default
|
|
| id metadata |
|---|
| key | value |
|---|
| macFileType | [ONLN] |
| macFileCreator | [HLX2] |
hex view+--------+-------------------------+-------------------------+--------+--------+
|00000000| 00 1e 49 6d 70 6c 65 6d | 65 6e 74 69 6e 67 20 4d |..Implem|enting M|
|00000010| 75 6c 74 69 70 61 6e 65 | 20 44 69 61 6c 6f 67 73 |ultipane| Dialogs|
|00000020| 00 00 00 00 00 00 00 00 | 00 00 00 00 00 00 00 00 |........|........|
|00000030| 00 00 00 00 00 00 00 00 | 00 00 00 00 00 00 00 00 |........|........|
|00000040| 00 4f 4e 4c 4e 48 4c 58 | 32 01 00 00 00 00 00 00 |.ONLNHLX|2.......|
|00000050| 00 00 00 00 08 b9 b7 00 | 00 0d 5c ab bc 54 b5 ab |........|..\..T..|
|00000060| bc 5e 2c 00 00 00 00 00 | 00 00 00 00 00 00 00 00 |.^,.....|........|
|00000070| 00 00 00 00 00 00 00 00 | 00 00 81 81 4c 27 00 00 |........|....L'..|
|00000080| 49 6d 70 6c 65 6d 65 6e | 74 69 6e 67 20 4d 75 6c |Implemen|ting Mul|
|00000090| 74 69 70 61 6e 65 20 44 | 69 61 6c 6f 67 73 09 09 |tipane D|ialogs..|
|000000a0| 0d 09 41 73 20 61 70 70 | 6c 69 63 61 74 69 6f 6e |..As app|lication|
|000000b0| 73 20 67 72 6f 77 20 69 | 6e 20 70 6f 77 65 72 20 |s grow i|n power |
|000000c0| 61 6e 64 20 63 6f 6d 70 | 6c 65 78 69 74 79 2c 20 |and comp|lexity, |
|000000d0| 73 6f 20 64 6f 65 73 20 | 74 68 65 20 74 65 6e 64 |so does |the tend|
|000000e0| 65 6e 63 79 20 74 6f 20 | 70 72 65 73 65 6e 74 20 |ency to |present |
|000000f0| 75 73 65 72 73 20 77 69 | 74 68 20 6e 75 6d 65 72 |users wi|th numer|
|00000100| 6f 75 73 20 63 6c 75 74 | 74 65 72 65 64 20 64 69 |ous clut|tered di|
|00000110| 61 6c 6f 67 20 62 6f 78 | 65 73 2e 20 54 6f 20 73 |alog box|es. To s|
|00000120| 69 6d 70 6c 69 66 79 20 | 74 68 65 20 75 73 65 72 |implify |the user|
|00000130| 20 69 6e 74 65 72 66 61 | 63 65 2c 20 64 65 76 65 | interfa|ce, deve|
|00000140| 6c 6f 70 65 72 73 20 61 | 72 65 20 6d 6f 76 69 6e |lopers a|re movin|
|00000150| 67 20 69 6e 63 72 65 61 | 73 69 6e 67 6c 79 20 74 |g increa|singly t|
|00000160| 6f 20 64 69 61 6c 6f 67 | 73 20 77 69 74 68 20 6d |o dialog|s with m|
|00000170| 75 6c 74 69 70 6c 65 20 | 70 61 6e 65 73 2e 20 54 |ultiple |panes. T|
|00000180| 68 69 73 20 61 72 74 69 | 63 6c 65 20 64 65 73 63 |his arti|cle desc|
|00000190| 72 69 62 65 73 20 68 6f | 77 20 74 6f 20 69 6d 70 |ribes ho|w to imp|
|000001a0| 6c 65 6d 65 6e 74 20 6d | 75 6c 74 69 70 61 6e 65 |lement m|ultipane|
|000001b0| 20 64 69 61 6c 6f 67 73 | 20 74 68 61 74 20 75 73 | dialogs| that us|
|000001c0| 65 72 73 20 6e 61 76 69 | 67 61 74 65 20 62 79 20 |ers navi|gate by |
|000001d0| 63 6c 69 63 6b 69 6e 67 | 20 69 6e 20 61 20 73 63 |clicking| in a sc|
|000001e0| 72 6f 6c 6c 69 6e 67 20 | 6c 69 73 74 20 6f 66 20 |rolling |list of |
|000001f0| 69 63 6f 6e 73 2e 09 0d | 0d 4e 4f 52 4d 41 4e 20 |icons...|.NORMAN |
|00000200| 46 52 41 4e 4b 45 0d 09 | 44 69 61 6c 6f 67 20 62 |FRANKE..|Dialog b|
|00000210| 6f 78 65 73 20 77 69 74 | 68 20 6d 75 6c 74 69 70 |oxes wit|h multip|
|00000220| 6c 65 20 70 61 6e 65 73 | 20 28 d2 70 61 67 65 73 |le panes| (.pages|
|00000230| d3 20 6f 66 20 63 6f 6e | 74 72 6f 6c 73 29 20 61 |. of con|trols) a|
|00000240| 72 65 20 61 6e 20 69 6e | 63 72 65 61 73 69 6e 67 |re an in|creasing|
|00000250| 6c 79 20 70 6f 70 75 6c | 61 72 20 65 6c 65 6d 65 |ly popul|ar eleme|
|00000260| 6e 74 20 6f 66 20 74 68 | 65 20 4d 61 63 69 6e 74 |nt of th|e Macint|
|00000270| 6f 73 68 20 75 73 65 72 | 20 69 6e 74 65 72 66 61 |osh user| interfa|
|00000280| 63 65 2e 20 4c 69 6b 65 | 20 73 69 6d 70 6c 65 20 |ce. Like| simple |
|00000290| 64 69 61 6c 6f 67 73 2c | 20 6d 75 6c 74 69 70 61 |dialogs,| multipa|
|000002a0| 6e 65 20 64 69 61 6c 6f | 67 73 20 63 61 6e 20 62 |ne dialo|gs can b|
|000002b0| 65 20 70 72 65 73 65 6e | 74 65 64 20 77 68 65 6e |e presen|ted when|
|000002c0| 20 75 73 65 72 73 20 6e | 65 65 64 20 74 6f 20 69 | users n|eed to i|
|000002d0| 6e 64 69 63 61 74 65 20 | 70 72 65 66 65 72 65 6e |ndicate |preferen|
|000002e0| 63 65 73 2c 20 73 65 74 | 20 61 74 74 72 69 62 75 |ces, set| attribu|
|000002f0| 74 65 73 20 6f 66 20 74 | 65 78 74 20 6f 72 20 67 |tes of t|ext or g|
|00000300| 72 61 70 68 69 63 20 6f | 62 6a 65 63 74 73 2c 20 |raphic o|bjects, |
|00000310| 6f 72 20 67 69 76 65 20 | 73 70 65 63 69 66 69 63 |or give |specific|
|00000320| 61 74 69 6f 6e 73 20 66 | 6f 72 20 63 6f 6d 70 6c |ations f|or compl|
|00000330| 65 78 20 6f 70 65 72 61 | 74 69 6f 6e 73 20 73 75 |ex opera|tions su|
|00000340| 63 68 20 61 73 20 73 65 | 61 72 63 68 65 73 20 6f |ch as se|arches o|
|00000350| 72 20 66 6f 72 6d 61 74 | 74 69 6e 67 2c 20 61 6d |r format|ting, am|
|00000360| 6f 6e 67 20 6f 74 68 65 | 72 20 74 68 69 6e 67 73 |ong othe|r things|
|00000370| 2e 20 42 79 20 67 72 6f | 75 70 69 6e 67 20 72 65 |. By gro|uping re|
|00000380| 6c 61 74 65 64 20 6f 70 | 74 69 6f 6e 73 20 61 6e |lated op|tions an|
|00000390| 64 20 70 72 6f 76 69 64 | 69 6e 67 20 61 20 73 69 |d provid|ing a si|
|000003a0| 6e 67 6c 65 20 70 6f 69 | 6e 74 20 6f 66 20 69 6e |ngle poi|nt of in|
|000003b0| 74 65 72 61 63 74 69 6f | 6e 20 66 6f 72 20 6d 61 |teractio|n for ma|
|000003c0| 6e 69 70 75 6c 61 74 69 | 6e 67 20 74 68 65 6d 2c |nipulati|ng them,|
|000003d0| 20 6d 75 6c 74 69 70 61 | 6e 65 20 64 69 61 6c 6f | multipa|ne dialo|
|000003e0| 67 73 20 73 69 6d 70 6c | 69 66 79 20 6c 69 66 65 |gs simpl|ify life|
|000003f0| 20 66 6f 72 20 74 68 65 | 20 75 73 65 72 20 61 6e | for the| user an|
|00000400| 64 20 74 68 65 20 64 65 | 76 65 6c 6f 70 65 72 2e |d the de|veloper.|
|00000410| 20 0d 46 69 76 65 20 64 | 69 66 66 65 72 65 6e 74 | .Five d|ifferent|
|00000420| 20 6b 69 6e 64 73 20 6f | 66 20 63 6f 6e 74 72 6f | kinds o|f contro|
|00000430| 6c 73 20 66 6f 72 20 6e | 61 76 69 67 61 74 69 6e |ls for n|avigatin|
|00000440| 67 20 6d 75 6c 74 69 70 | 61 6e 65 20 64 69 61 6c |g multip|ane dial|
|00000450| 6f 67 73 20 61 72 65 20 | 69 6e 20 67 65 6e 65 72 |ogs are |in gener|
|00000460| 61 6c 20 75 73 65 3a 20 | 74 68 65 20 73 63 72 6f |al use: |the scro|
|00000470| 6c 6c 69 6e 67 20 6c 69 | 73 74 20 6f 66 20 69 63 |lling li|st of ic|
|00000480| 6f 6e 73 2c 20 74 68 65 | 20 70 6f 70 2d 75 70 20 |ons, the| pop-up |
|00000490| 6d 65 6e 75 2c 20 69 6e | 64 65 78 20 74 61 62 73 |menu, in|dex tabs|
|000004a0| 20 28 73 69 6d 75 6c 61 | 74 69 6e 67 20 74 68 65 | (simula|ting the|
|000004b0| 20 6c 6f 6f 6b 20 6f 66 | 20 74 61 62 73 20 6f 6e | look of| tabs on|
|000004c0| 20 74 68 65 20 74 6f 70 | 73 20 6f 66 20 66 69 6c | the top|s of fil|
|000004d0| 65 20 66 6f 6c 64 65 72 | 73 20 69 6e 20 61 20 66 |e folder|s in a f|
|000004e0| 69 6c 65 20 63 61 62 69 | 6e 65 74 29 2c 20 4e 65 |ile cabi|net), Ne|
|000004f0| 78 74 2f 50 72 65 76 69 | 6f 75 73 20 62 75 74 74 |xt/Previ|ous butt|
|00000500| 6f 6e 73 2c 20 61 6e 64 | 20 69 63 6f 6e 20 62 75 |ons, and| icon bu|
|00000510| 74 74 6f 6e 20 73 65 74 | 73 2e 20 41 6c 74 68 6f |tton set|s. Altho|
|00000520| 75 67 68 20 74 68 65 72 | 65 20 61 72 65 6e d5 74 |ugh ther|e aren.t|
|00000530| 20 61 6e 79 20 68 61 72 | 64 2d 61 6e 64 2d 66 61 | any har|d-and-fa|
|00000540| 73 74 20 72 75 6c 65 73 | 20 61 62 6f 75 74 20 77 |st rules| about w|
|00000550| 68 65 6e 20 79 6f 75 20 | 73 68 6f 75 6c 64 20 75 |hen you |should u|
|00000560| 73 65 20 6f 6e 65 20 6f | 76 65 72 20 61 6e 6f 74 |se one o|ver anot|
|00000570| 68 65 72 2c 20 74 68 65 | 73 65 20 63 6f 6e 73 69 |her, the|se consi|
|00000580| 64 65 72 61 74 69 6f 6e | 73 20 28 73 75 67 67 65 |deration|s (sugge|
|00000590| 73 74 65 64 20 62 79 20 | 45 6c 69 7a 61 62 65 74 |sted by |Elizabet|
|000005a0| 68 20 4d 6f 6c 6c 65 72 | 20 6f 66 20 41 70 70 6c |h Moller| of Appl|
|000005b0| 65 d5 73 20 48 75 6d 61 | 6e 20 49 6e 74 65 72 66 |e.s Huma|n Interf|
|000005c0| 61 63 65 20 44 65 73 69 | 67 6e 20 43 65 6e 74 65 |ace Desi|gn Cente|
|000005d0| 72 29 20 67 65 6e 65 72 | 61 6c 6c 79 20 61 70 70 |r) gener|ally app|
|000005e0| 6c 79 3a 0d a5 09 4e 6f | 76 69 63 65 20 75 73 65 |ly:...No|vice use|
|000005f0| 72 73 20 68 61 76 65 20 | 74 72 6f 75 62 6c 65 20 |rs have |trouble |
|00000600| 77 69 74 68 20 70 6f 70 | 2d 75 70 20 6d 65 6e 75 |with pop|-up menu|
|00000610| 73 2c 20 73 6f 20 63 68 | 6f 6f 73 65 20 61 20 64 |s, so ch|oose a d|
|00000620| 69 66 66 65 72 65 6e 74 | 20 6b 69 6e 64 20 6f 66 |ifferent| kind of|
|00000630| 20 63 6f 6e 74 72 6f 6c | 20 69 66 20 79 6f 75 72 | control| if your|
|00000640| 20 74 61 72 67 65 74 20 | 61 75 64 69 65 6e 63 65 | target |audience|
|00000650| 20 69 6e 63 6c 75 64 65 | 73 20 6c 61 72 67 65 20 | include|s large |
|00000660| 6e 75 6d 62 65 72 73 20 | 6f 66 20 74 68 65 73 65 |numbers |of these|
|00000670| 20 75 73 65 72 73 2e 20 | 0d a5 09 49 6e 64 65 78 | users. |...Index|
|00000680| 20 74 61 62 73 20 77 6f | 72 6b 20 77 65 6c 6c 20 | tabs wo|rk well |
|00000690| 66 6f 72 20 73 6d 61 6c | 6c 20 6e 75 6d 62 65 72 |for smal|l number|
|000006a0| 73 20 6f 66 20 70 61 6e | 65 73 2c 20 62 75 74 20 |s of pan|es, but |
|000006b0| 74 68 65 79 20 6d 61 79 | 20 6e 6f 74 20 77 6f 72 |they may| not wor|
|000006c0| 6b 20 77 65 6c 6c 20 77 | 68 65 6e 20 74 68 65 20 |k well w|hen the |
|000006d0| 74 61 62 73 20 73 74 61 | 72 74 20 6f 76 65 72 6c |tabs sta|rt overl|
|000006e0| 61 70 70 69 6e 67 20 6f | 72 20 74 68 65 20 6e 75 |apping o|r the nu|
|000006f0| 6d 62 65 72 20 6f 66 20 | 70 61 6e 65 73 20 69 73 |mber of |panes is|
|00000700| 20 76 61 72 69 61 62 6c | 65 2e 20 0d a5 09 4e 65 | variabl|e. ...Ne|
|00000710| 78 74 2f 50 72 65 76 69 | 6f 75 73 20 62 75 74 74 |xt/Previ|ous butt|
|00000720| 6f 6e 73 20 61 72 65 20 | 61 20 67 6f 6f 64 20 63 |ons are |a good c|
|00000730| 68 6f 69 63 65 20 77 68 | 65 6e 20 74 68 65 72 65 |hoice wh|en there|
|00000740| d5 73 20 6d 6f 72 65 20 | 74 68 61 6e 20 6f 6e 65 |.s more |than one|
|00000750| 20 6d 61 6e 64 61 74 6f | 72 79 20 70 61 6e 65 2e | mandato|ry pane.|
|00000760| 20 54 68 65 79 20 6d 61 | 6b 65 20 69 74 20 65 61 | They ma|ke it ea|
|00000770| 73 79 20 66 6f 72 20 75 | 73 65 72 73 20 74 6f 20 |sy for u|sers to |
|00000780| 73 74 65 70 20 74 68 72 | 6f 75 67 68 20 6d 61 6e |step thr|ough man|
|00000790| 64 61 74 6f 72 79 20 61 | 6e 64 20 6f 70 74 69 6f |datory a|nd optio|
|000007a0| 6e 61 6c 20 70 61 6e 65 | 73 20 69 6e 20 73 65 71 |nal pane|s in seq|
|000007b0| 75 65 6e 63 65 2e 0d 54 | 68 65 20 73 61 6d 70 6c |uence..T|he sampl|
|000007c0| 65 20 61 70 70 6c 69 63 | 61 74 69 6f 6e 20 4d 50 |e applic|ation MP|
|000007d0| 44 69 61 6c 6f 67 73 20 | 6f 6e 20 74 68 69 73 20 |Dialogs |on this |
|000007e0| 69 73 73 75 65 d5 73 20 | 43 44 20 64 65 6d 6f 6e |issue.s |CD demon|
|000007f0| 73 74 72 61 74 65 73 20 | 74 68 65 20 75 73 65 20 |strates |the use |
|00000800| 6f 66 20 61 20 6d 75 6c | 74 69 70 61 6e 65 20 70 |of a mul|tipane p|
|00000810| 72 65 66 65 72 65 6e 63 | 65 73 20 64 69 61 6c 6f |referenc|es dialo|
|00000820| 67 20 6e 61 76 69 67 61 | 74 65 64 20 62 79 20 63 |g naviga|ted by c|
|00000830| 6c 69 63 6b 69 6e 67 20 | 69 6e 20 61 20 73 63 72 |licking |in a scr|
|00000840| 6f 6c 6c 69 6e 67 20 6c | 69 73 74 20 6f 66 20 69 |olling l|ist of i|
|00000850| 63 6f 6e 73 2c 20 73 69 | 6d 69 6c 61 72 20 74 6f |cons, si|milar to|
|00000860| 20 74 68 65 20 43 6f 6e | 74 72 6f 6c 20 50 61 6e | the Con|trol Pan|
|00000870| 65 6c 20 69 6e 20 53 79 | 73 74 65 6d 20 36 20 61 |el in Sy|stem 6 a|
|00000880| 6e 64 20 70 72 69 6e 74 | 20 64 69 61 6c 6f 67 73 |nd print| dialogs|
|00000890| 20 69 6e 20 51 75 69 63 | 6b 44 72 61 77 20 47 58 | in Quic|kDraw GX|
|000008a0| 2e 20 41 66 74 65 72 20 | 64 65 73 63 72 69 62 69 |. After |describi|
|000008b0| 6e 67 20 74 68 65 20 75 | 73 65 72 20 69 6e 74 65 |ng the u|ser inte|
|000008c0| 72 66 61 63 65 20 70 72 | 65 73 65 6e 74 65 64 20 |rface pr|esented |
|000008d0| 62 79 20 74 68 69 73 20 | 73 61 6d 70 6c 65 20 70 |by this |sample p|
|000008e0| 72 6f 67 72 61 6d 2c 20 | 49 d5 6c 6c 20 67 6f 20 |rogram, |I.ll go |
|000008f0| 69 6e 74 6f 20 74 68 65 | 20 64 65 74 61 69 6c 73 |into the| details|
|00000900| 20 6f 66 20 68 6f 77 20 | 74 6f 20 69 6d 70 6c 65 | of how |to imple|
|00000910| 6d 65 6e 74 20 61 20 73 | 69 6d 69 6c 61 72 20 6d |ment a s|imilar m|
|00000920| 75 6c 74 69 70 61 6e 65 | 20 64 69 61 6c 6f 67 20 |ultipane| dialog |
|00000930| 69 6e 20 79 6f 75 72 20 | 6f 77 6e 20 61 70 70 6c |in your |own appl|
|00000940| 69 63 61 74 69 6f 6e 2e | 20 53 6f 75 72 63 65 20 |ication.| Source |
|00000950| 63 6f 64 65 20 0d 09 0d | 4e 4f 52 4d 41 4e 20 46 |code ...|NORMAN F|
|00000960| 52 41 4e 4b 45 20 6d 69 | 73 73 65 73 20 74 68 65 |RANKE mi|sses the|
|00000970| 20 6c 61 72 67 65 20 65 | 6c 65 63 74 72 69 63 61 | large e|lectrica|
|00000980| 6c 20 73 74 6f 72 6d 73 | 20 61 6e 64 20 67 72 65 |l storms| and gre|
|00000990| 65 6e 20 74 68 69 6e 67 | 73 20 6f 66 20 68 69 73 |en thing|s of his|
|000009a0| 20 6e 61 74 69 76 65 20 | 50 65 6e 6e 73 79 6c 76 | native |Pennsylv|
|000009b0| 61 6e 69 61 2c 20 62 75 | 74 20 6e 6f 74 20 74 68 |ania, bu|t not th|
|000009c0| 65 20 68 75 6d 69 64 69 | 74 79 2e 20 48 65 d5 73 |e humidi|ty. He.s|
|000009d0| 20 75 73 69 6e 67 20 74 | 68 65 20 42 2e 53 2e 20 | using t|he B.S. |
|000009e0| 69 6e 20 63 6f 6d 70 75 | 74 65 72 20 73 63 69 65 |in compu|ter scie|
|000009f0| 6e 63 65 20 68 65 20 65 | 61 72 6e 65 64 20 66 72 |nce he e|arned fr|
|00000a00| 6f 6d 20 43 61 72 6e 65 | 67 69 65 20 4d 65 6c 6c |om Carne|gie Mell|
|00000a10| 6f 6e 20 61 73 20 68 65 | 20 77 72 69 74 65 73 20 |on as he| writes |
|00000a20| 4d 61 63 69 6e 74 6f 73 | 68 20 73 6f 66 74 77 61 |Macintos|h softwa|
|00000a30| 72 65 20 66 6f 72 20 61 | 20 6c 61 72 67 65 20 6e |re for a| large n|
|00000a40| 61 74 69 6f 6e 61 6c 20 | 09 6c 61 62 6f 72 61 74 |ational |.laborat|
|00000a50| 6f 72 79 20 69 6e 20 6e | 6f 72 74 68 65 72 6e 20 |ory in n|orthern |
|00000a60| 43 61 6c 69 66 6f 72 6e | 69 61 2e 20 4e 6f 77 20 |Californ|ia. Now |
|00000a70| 77 6f 72 6b 69 6e 67 20 | 6f 6e 20 61 6e 20 4d 2e |working |on an M.|
|00000a80| 53 2e 20 69 6e 20 63 6f | 6d 70 75 74 65 72 20 73 |S. in co|mputer s|
|00000a90| 63 69 65 6e 63 65 20 61 | 74 20 53 74 61 6e 66 6f |cience a|t Stanfo|
|00000aa0| 72 64 2c 20 68 65 20 65 | 6e 6a 6f 79 73 20 77 72 |rd, he e|njoys wr|
|00000ab0| 69 74 69 6e 67 20 73 6f | 75 6e 64 20 6d 61 6e 69 |iting so|und mani|
|00000ac0| 70 75 6c 61 74 69 6f 6e | 20 73 6f 66 74 77 61 72 |pulation| softwar|
|00000ad0| 65 20 66 6f 72 20 68 69 | 73 20 4d 61 63 69 6e 74 |e for hi|s Macint|
|00000ae0| 6f 73 68 20 61 6e 64 20 | 77 61 74 63 68 69 6e 67 |osh and |watching|
|00000af0| 20 63 6c 61 73 73 69 63 | 20 61 6e 64 20 61 63 74 | classic| and act|
|00000b00| 69 6f 6e 2f 61 64 76 65 | 6e 74 75 72 65 20 6d 6f |ion/adve|nture mo|
|00000b10| 76 69 65 73 20 69 6e 20 | 68 69 73 20 73 70 61 72 |vies in |his spar|
|00000b20| 65 20 74 69 6d 65 2e a5 | 09 0d 66 6f 72 20 74 68 |e time..|..for th|
|00000b30| 65 20 72 6f 75 74 69 6e | 65 73 20 49 d5 6c 6c 20 |e routin|es I.ll |
|00000b40| 64 69 73 63 75 73 73 20 | 69 73 20 61 6c 73 6f 20 |discuss |is also |
|00000b50| 69 6e 63 6c 75 64 65 64 | 20 6f 6e 20 74 68 65 20 |included| on the |
|00000b60| 43 44 2e 20 54 68 69 73 | 20 63 6f 64 65 20 72 65 |CD. This| code re|
|00000b70| 71 75 69 72 65 73 20 53 | 79 73 74 65 6d 20 37 20 |quires S|ystem 7 |
|00000b80| 61 6e 64 20 69 73 20 63 | 6f 6d 70 61 74 69 62 6c |and is c|ompatibl|
|00000b90| 65 20 77 69 74 68 20 62 | 6f 74 68 20 62 6c 61 63 |e with b|oth blac|
|00000ba0| 6b 2d 61 6e 64 2d 77 68 | 69 74 65 20 61 6e 64 20 |k-and-wh|ite and |
|00000bb0| 63 6f 6c 6f 72 20 64 69 | 73 70 6c 61 79 73 2e 20 |color di|splays. |
|00000bc0| 0d 57 48 41 54 20 54 48 | 45 20 55 53 45 52 20 49 |.WHAT TH|E USER I|
|00000bd0| 4e 54 45 52 46 41 43 45 | 20 4c 4f 4f 4b 53 20 4c |NTERFACE| LOOKS L|
|00000be0| 49 4b 45 0d 54 6f 20 65 | 78 70 65 72 69 65 6e 63 |IKE.To e|xperienc|
|00000bf0| 65 20 68 6f 77 20 6d 75 | 6c 74 69 70 61 6e 65 20 |e how mu|ltipane |
|00000c00| 64 69 61 6c 6f 67 73 20 | 77 6f 72 6b 2c 20 72 75 |dialogs |work, ru|
|00000c10| 6e 20 74 68 65 20 73 61 | 6d 70 6c 65 20 70 72 6f |n the sa|mple pro|
|00000c20| 67 72 61 6d 20 4d 50 44 | 69 61 6c 6f 67 73 2e 20 |gram MPD|ialogs. |
|00000c30| 57 68 65 6e 20 79 6f 75 | 20 63 68 6f 6f 73 65 20 |When you| choose |
|00000c40| 50 72 65 66 65 72 65 6e | 63 65 73 20 66 72 6f 6d |Preferen|ces from|
|00000c50| 20 74 68 65 20 46 69 6c | 65 20 6d 65 6e 75 2c 20 | the Fil|e menu, |
|00000c60| 79 6f 75 d5 6c 6c 20 62 | 65 20 70 72 65 73 65 6e |you.ll b|e presen|
|00000c70| 74 65 64 20 77 69 74 68 | 20 74 68 65 20 69 6e 74 |ted with| the int|
|00000c80| 65 72 66 61 63 65 20 73 | 68 6f 77 6e 20 69 6e 20 |erface s|hown in |
|00000c90| 46 69 67 75 72 65 20 31 | 2e 20 54 68 69 73 20 69 |Figure 1|. This i|
|00000ca0| 73 20 61 20 67 6f 6f 64 | 20 69 6c 6c 75 73 74 72 |s a good| illustr|
|00000cb0| 61 74 69 6f 6e 20 6f 66 | 20 74 68 65 20 65 6c 65 |ation of| the ele|
|00000cc0| 6d 65 6e 74 73 20 6f 66 | 20 61 20 6d 75 6c 74 69 |ments of| a multi|
|00000cd0| 70 61 6e 65 20 64 69 61 | 6c 6f 67 2e 20 0d 46 69 |pane dia|log. .Fi|
|00000ce0| 67 75 72 65 20 31 2e 20 | 54 68 65 20 43 6f 6d 6d |gure 1. |The Comm|
|00000cf0| 75 6e 69 63 61 74 69 6f | 6e 73 20 70 61 6e 65 20 |unicatio|ns pane |
|00000d00| 6f 66 20 74 68 65 20 73 | 61 6d 70 6c 65 20 6d 75 |of the s|ample mu|
|00000d10| 6c 74 69 70 61 6e 65 20 | 64 69 61 6c 6f 67 20 0d |ltipane |dialog .|
|00000d20| 54 68 65 20 6c 6f 6e 67 | 20 76 65 72 74 69 63 61 |The long| vertica|
|00000d30| 6c 20 72 65 63 74 61 6e | 67 6c 65 20 6f 6e 20 74 |l rectan|gle on t|
|00000d40| 68 65 20 6c 65 66 74 20 | 73 69 64 65 20 6f 66 20 |he left |side of |
|00000d50| 74 68 65 20 64 69 61 6c | 6f 67 20 63 6f 6e 74 61 |the dial|og conta|
|00000d60| 69 6e 73 20 74 68 65 20 | 70 61 6e 65 20 73 65 6c |ins the |pane sel|
|00000d70| 65 63 74 69 6f 6e 20 69 | 63 6f 6e 20 6c 69 73 74 |ection i|con list|
|00000d80| 2e 20 45 61 63 68 20 69 | 63 6f 6e 20 69 6e 20 74 |. Each i|con in t|
|00000d90| 68 69 73 20 73 63 72 6f | 6c 6c 69 6e 67 20 6c 69 |his scro|lling li|
|00000da0| 73 74 20 68 61 73 20 61 | 20 6f 6e 65 2d 77 6f 72 |st has a| one-wor|
|00000db0| 64 20 6c 61 62 65 6c 20 | 75 6e 64 65 72 20 69 74 |d label |under it|
|00000dc0| 20 66 6f 72 20 69 64 65 | 6e 74 69 66 69 63 61 74 | for ide|ntificat|
|00000dd0| 69 6f 6e 20 61 6e 64 20 | 72 65 70 72 65 73 65 6e |ion and |represen|
|00000de0| 74 73 20 6f 6e 65 20 70 | 61 6e 65 20 6f 66 20 74 |ts one p|ane of t|
|00000df0| 68 65 20 64 69 61 6c 6f | 67 2c 20 77 68 69 63 68 |he dialo|g, which|
|00000e00| 20 69 73 20 64 69 73 70 | 6c 61 79 65 64 20 77 68 | is disp|layed wh|
|00000e10| 65 6e 20 74 68 65 20 75 | 73 65 72 20 63 6c 69 63 |en the u|ser clic|
|00000e20| 6b 73 20 74 68 65 20 69 | 63 6f 6e 2e 20 49 66 20 |ks the i|con. If |
|00000e30| 79 6f 75 20 63 6c 69 63 | 6b 20 74 68 65 20 44 65 |you clic|k the De|
|00000e40| 66 65 6e 73 65 20 69 63 | 6f 6e 2c 20 66 6f 72 20 |fense ic|on, for |
|00000e50| 69 6e 73 74 61 6e 63 65 | 2c 20 79 6f 75 d5 6c 6c |instance|, you.ll|
|00000e60| 20 73 65 65 20 74 68 65 | 20 70 61 6e 65 20 73 68 | see the| pane sh|
|00000e70| 6f 77 6e 20 69 6e 20 46 | 69 67 75 72 65 20 32 2e |own in F|igure 2.|
|00000e80| 20 54 68 65 20 61 72 72 | 6f 77 20 61 6e 64 20 74 | The arr|ow and t|
|00000e90| 61 62 20 6b 65 79 73 20 | 6f 6e 20 74 68 65 20 6b |ab keys |on the k|
|00000ea0| 65 79 62 6f 61 72 64 20 | 63 61 6e 20 61 6c 73 6f |eyboard |can also|
|00000eb0| 20 62 65 20 75 73 65 64 | 20 74 6f 20 63 68 61 6e | be used| to chan|
|00000ec0| 67 65 20 74 68 65 20 70 | 61 6e 65 20 73 65 6c 65 |ge the p|ane sele|
|00000ed0| 63 74 69 6f 6e 3b 20 68 | 6f 77 65 76 65 72 2c 20 |ction; h|owever, |
|00000ee0| 69 66 20 74 68 65 20 63 | 75 72 72 65 6e 74 20 70 |if the c|urrent p|
|00000ef0| 61 6e 65 20 63 6f 6e 74 | 61 69 6e 73 20 6d 75 6c |ane cont|ains mul|
|00000f00| 74 69 70 6c 65 20 65 64 | 69 74 61 62 6c 65 20 74 |tiple ed|itable t|
|00000f10| 65 78 74 20 66 69 65 6c | 64 73 2c 20 74 68 65 20 |ext fiel|ds, the |
|00000f20| 74 61 62 20 6b 65 79 20 | 77 69 6c 6c 20 77 6f 72 |tab key |will wor|
|00000f30| 6b 20 61 73 20 69 6e 20 | 61 20 6e 6f 72 6d 61 6c |k as in |a normal|
|00000f40| 20 64 69 61 6c 6f 67 20 | 61 6e 64 20 6d 6f 76 65 | dialog |and move|
|00000f50| 20 74 68 65 20 63 75 72 | 73 6f 72 20 74 6f 20 74 | the cur|sor to t|
|00000f60| 68 65 20 6e 65 78 74 20 | 74 65 78 74 20 66 69 65 |he next |text fie|
|00000f70| 6c 64 2e 0d 54 68 65 20 | 62 6f 74 74 6f 6d 20 70 |ld..The |bottom p|
|00000f80| 6f 72 74 69 6f 6e 20 6f | 66 20 74 68 65 20 64 69 |ortion o|f the di|
|00000f90| 61 6c 6f 67 20 62 65 6c | 6f 77 20 74 68 65 20 6c |alog bel|ow the l|
|00000fa0| 69 6e 65 20 63 6f 6e 74 | 61 69 6e 73 20 74 77 6f |ine cont|ains two|
|00000fb0| 20 62 75 74 74 6f 6e 73 | 20 74 68 61 74 20 61 63 | buttons| that ac|
|00000fc0| 74 20 6f 6e 20 74 68 65 | 20 64 69 61 6c 6f 67 20 |t on the| dialog |
|00000fd0| 61 73 20 61 20 77 68 6f | 6c 65 3a 20 43 61 6e 63 |as a who|le: Canc|
|00000fe0| 65 6c 20 61 6e 64 20 4f | 4b 2e 20 54 68 65 20 4f |el and O|K. The O|
|00000ff0| 4b 20 62 75 74 74 6f 6e | 20 61 63 63 65 70 74 73 |K button| accepts|
|00001000| 20 74 68 65 20 73 65 74 | 74 69 6e 67 73 20 61 6e | the set|tings an|
|00001010| 64 20 43 61 6e 63 65 6c | 20 61 62 6f 72 74 73 20 |d Cancel| aborts |
|00001020| 61 6c 6c 20 63 68 61 6e | 67 65 73 20 61 6e 64 20 |all chan|ges and |
|00001030| 63 6c 6f 73 65 73 20 74 | 68 65 20 64 69 61 6c 6f |closes t|he dialo|
|00001040| 67 2e 20 54 68 65 20 74 | 77 6f 20 62 75 74 74 6f |g. The t|wo butto|
|00001050| 6e 73 20 61 62 6f 76 65 | 20 74 68 65 20 6c 69 6e |ns above| the lin|
|00001060| 65 20 61 63 74 20 6f 6e | 6c 79 20 6f 6e 20 74 68 |e act on|ly on th|
|00001070| 65 20 63 75 72 72 65 6e | 74 20 70 61 6e 65 20 61 |e curren|t pane a|
|00001080| 6e 64 20 61 72 65 20 6f | 70 74 69 6f 6e 61 6c 3a |nd are o|ptional:|
|00001090| 20 52 65 76 65 72 74 20 | 72 65 73 74 6f 72 65 73 | Revert |restores|
|000010a0| 20 74 68 65 20 63 6f 6e | 74 72 6f 6c 20 76 61 6c | the con|trol val|
|000010b0| 75 65 73 20 69 6e 20 74 | 68 65 20 63 75 72 72 65 |ues in t|he curre|
|000010c0| 6e 74 20 70 61 6e 65 20 | 74 6f 20 77 68 61 74 20 |nt pane |to what |
|000010d0| 74 68 65 79 20 77 65 72 | 65 20 77 68 65 6e 20 74 |they wer|e when t|
|000010e0| 68 61 74 20 70 61 6e 65 | 20 77 61 73 20 6c 61 73 |hat pane| was las|
|000010f0| 74 20 6f 70 65 6e 65 64 | 2c 20 61 6e 64 20 55 73 |t opened|, and Us|
|00001100| 65 20 44 65 66 61 75 6c | 74 73 20 72 65 73 65 74 |e Defaul|ts reset|
|00001110| 73 20 74 68 65 20 63 6f | 6e 74 72 6f 6c 20 76 61 |s the co|ntrol va|
|00001120| 6c 75 65 73 20 69 6e 20 | 74 68 61 74 20 70 61 6e |lues in |that pan|
|00001130| 65 20 74 6f 20 66 61 63 | 74 6f 72 79 20 64 65 66 |e to fac|tory def|
|00001140| 61 75 6c 74 73 2e 20 0d | 54 68 65 20 6c 61 72 67 |aults. .|The larg|
|00001150| 65 20 72 65 67 69 6f 6e | 20 61 62 6f 76 65 20 74 |e region| above t|
|00001160| 68 65 20 62 75 74 74 6f | 6e 73 20 69 73 20 77 68 |he butto|ns is wh|
|00001170| 65 72 65 20 74 68 65 20 | 70 61 6e 65 d5 73 20 63 |ere the |pane.s c|
|00001180| 6f 6e 74 72 6f 6c 73 20 | 61 72 65 20 70 6c 61 63 |ontrols |are plac|
|00001190| 65 64 2e 20 54 68 65 20 | 73 61 6d 70 6c 65 20 63 |ed. The |sample c|
|000011a0| 6f 64 65 20 73 75 70 70 | 6c 69 65 64 20 6f 6e 20 |ode supp|lied on |
|000011b0| 74 68 65 20 43 44 20 68 | 61 6e 64 6c 65 73 20 61 |the CD h|andles a|
|000011c0| 63 74 69 6f 6e 73 20 66 | 6f 72 20 63 68 65 63 6b |ctions f|or check|
|000011d0| 62 6f 78 65 73 2c 20 72 | 61 64 69 6f 20 62 75 74 |boxes, r|adio but|
|000011e0| 74 6f 6e 20 67 72 6f 75 | 70 73 2c 20 61 6e 64 20 |ton grou|ps, and |
|000011f0| 70 6f 70 2d 75 70 20 6d | 65 6e 75 73 2e 20 43 6f |pop-up m|enus. Co|
|00001200| 6d 6d 61 6e 64 2d 6b 65 | 79 20 65 71 75 69 76 61 |mmand-ke|y equiva|
|00001210| 6c 65 6e 74 73 20 63 61 | 6e 20 62 65 20 75 73 65 |lents ca|n be use|
|00001220| 64 20 74 6f 20 74 6f 67 | 67 6c 65 20 63 68 65 63 |d to tog|gle chec|
|00001230| 6b 62 6f 78 65 73 20 61 | 6e 64 20 72 61 64 69 6f |kboxes a|nd radio|
|00001240| 20 62 75 74 74 6f 6e 73 | 2c 20 69 6e 20 61 64 64 | buttons|, in add|
|00001250| 69 74 69 6f 6e 20 74 6f | 20 74 68 65 20 73 74 61 |ition to| the sta|
|00001260| 6e 64 61 72 64 20 6b 65 | 79 62 6f 61 72 64 20 65 |ndard ke|yboard e|
|00001270| 71 75 69 76 61 6c 65 6e | 74 73 20 66 6f 72 20 4f |quivalen|ts for O|
|00001280| 4b 20 28 52 65 74 75 72 | 6e 2f 45 6e 74 65 72 29 |K (Retur|n/Enter)|
|00001290| 20 61 6e 64 20 43 61 6e | 63 65 6c 20 28 45 73 63 | and Can|cel (Esc|
|000012a0| 61 70 65 2f 43 6f 6d 6d | 61 6e 64 2d 70 65 72 69 |ape/Comm|and-peri|
|000012b0| 6f 64 29 2e 20 41 66 74 | 65 72 20 65 78 70 65 72 |od). Aft|er exper|
|000012c0| 69 6d 65 6e 74 69 6e 67 | 20 77 69 74 68 20 6d 61 |imenting| with ma|
|000012d0| 6b 69 6e 67 20 63 68 61 | 6e 67 65 73 20 74 6f 20 |king cha|nges to |
|000012e0| 74 68 65 20 63 6f 6e 74 | 72 6f 6c 20 76 61 6c 75 |the cont|rol valu|
|000012f0| 65 73 20 69 6e 20 74 68 | 65 20 73 61 6d 70 6c 65 |es in th|e sample|
|00001300| 20 70 72 6f 67 72 61 6d | 2c 20 79 6f 75 20 63 61 | program|, you ca|
|00001310| 6e 20 63 68 6f 6f 73 65 | 20 44 69 73 70 6c 61 79 |n choose| Display|
|00001320| 20 66 72 6f 6d 20 74 68 | 65 20 46 69 6c 65 20 6d | from th|e File m|
|00001330| 65 6e 75 20 74 6f 20 73 | 65 65 20 74 68 65 20 72 |enu to s|ee the r|
|00001340| 65 73 75 6c 74 73 20 6f | 66 20 79 6f 75 72 20 63 |esults o|f your c|
|00001350| 68 61 6e 67 65 73 2e 20 | 0d 46 69 67 75 72 65 20 |hanges. |.Figure |
|00001360| 32 2e 20 54 68 65 20 44 | 65 66 65 6e 73 65 20 70 |2. The D|efense p|
|00001370| 61 6e 65 20 6f 66 20 74 | 68 65 20 73 61 6d 70 6c |ane of t|he sampl|
|00001380| 65 20 6d 75 6c 74 69 70 | 61 6e 65 20 64 69 61 6c |e multip|ane dial|
|00001390| 6f 67 0d 41 20 63 6f 75 | 70 6c 65 20 6f 66 20 63 |og.A cou|ple of c|
|000013a0| 75 73 74 6f 6d 20 63 61 | 70 61 62 69 6c 69 74 69 |ustom ca|pabiliti|
|000013b0| 65 73 20 63 61 6e 20 62 | 65 20 61 64 64 65 64 20 |es can b|e added |
|000013c0| 74 6f 20 61 20 70 61 6e | 65 20 74 68 72 6f 75 67 |to a pan|e throug|
|000013d0| 68 20 6f 70 74 69 6f 6e | 61 6c 20 70 72 6f 63 65 |h option|al proce|
|000013e0| 64 75 72 65 73 3a 20 0d | a5 09 74 61 6b 69 6e 67 |dures: .|..taking|
|000013f0| 20 73 70 65 63 69 61 6c | 20 61 63 74 69 6f 6e 20 | special| action |
|00001400| 73 75 63 68 20 61 73 20 | 64 69 6d 6d 69 6e 67 20 |such as |dimming |
|00001410| 6f 72 20 75 6e 64 69 6d | 6d 69 6e 67 20 6f 74 68 |or undim|ming oth|
|00001420| 65 72 20 63 6f 6e 74 72 | 6f 6c 73 20 77 68 65 6e |er contr|ols when|
|00001430| 20 69 74 65 6d 73 20 61 | 72 65 20 63 6c 69 63 6b | items a|re click|
|00001440| 65 64 0d a5 09 70 65 72 | 66 6f 72 6d 69 6e 67 20 |ed...per|forming |
|00001450| 64 61 74 61 20 76 61 6c | 69 64 61 74 69 6f 6e 20 |data val|idation |
|00001460| 73 75 63 68 20 74 68 61 | 74 20 69 66 20 76 61 6c |such tha|t if val|
|00001470| 69 64 61 74 69 6f 6e 20 | 66 61 69 6c 73 2c 20 74 |idation |fails, t|
|00001480| 68 65 20 75 73 65 72 20 | 69 73 6e d5 74 20 70 65 |he user |isn.t pe|
|00001490| 72 6d 69 74 74 65 64 20 | 74 6f 20 63 68 61 6e 67 |rmitted |to chang|
|000014a0| 65 20 70 61 6e 65 73 20 | 6f 72 20 65 78 69 74 20 |e panes |or exit |
|000014b0| 74 68 65 20 64 69 61 6c | 6f 67 20 77 69 74 68 20 |the dial|og with |
|000014c0| 74 68 65 20 4f 4b 20 62 | 75 74 74 6f 6e 0d 54 68 |the OK b|utton.Th|
|000014d0| 65 73 65 20 74 77 6f 20 | 63 61 70 61 62 69 6c 69 |ese two |capabili|
|000014e0| 74 69 65 73 20 61 72 65 | 20 64 65 6d 6f 6e 73 74 |ties are| demonst|
|000014f0| 72 61 74 65 64 20 69 6e | 20 74 68 65 20 73 61 6d |rated in| the sam|
|00001500| 70 6c 65 20 6d 75 6c 74 | 69 70 61 6e 65 20 64 69 |ple mult|ipane di|
|00001510| 61 6c 6f 67 2e 20 57 68 | 65 6e 20 79 6f 75 20 63 |alog. Wh|en you c|
|00001520| 6c 69 63 6b 20 74 68 65 | 20 45 6e 61 62 6c 65 20 |lick the| Enable |
|00001530| 53 65 6c 66 2d 44 65 73 | 74 72 75 63 74 20 63 68 |Self-Des|truct ch|
|00001540| 65 63 6b 62 6f 78 20 69 | 6e 20 74 68 65 20 44 65 |eckbox i|n the De|
|00001550| 66 65 6e 73 65 20 70 61 | 6e 65 2c 20 74 68 65 20 |fense pa|ne, the |
|00001560| 53 65 6c 66 2d 44 65 73 | 74 72 75 63 74 20 63 68 |Self-Des|truct ch|
|00001570| 65 63 6b 62 6f 78 20 69 | 73 20 75 6e 64 69 6d 6d |eckbox i|s undimm|
|00001580| 65 64 2e 20 57 68 65 6e | 20 79 6f 75 20 65 6e 74 |ed. When| you ent|
|00001590| 65 72 20 6e 6f 6e 64 69 | 67 69 74 73 20 69 6e 20 |er nondi|gits in |
|000015a0| 74 68 65 20 65 64 69 74 | 61 62 6c 65 20 74 65 78 |the edit|able tex|
|000015b0| 74 20 66 69 65 6c 64 20 | 69 6e 20 74 68 65 20 43 |t field |in the C|
|000015c0| 6f 6d 6d 75 6e 69 63 61 | 74 69 6f 6e 73 20 70 61 |ommunica|tions pa|
|000015d0| 6e 65 2c 20 64 61 74 61 | 20 76 61 6c 69 64 61 74 |ne, data| validat|
|000015e0| 69 6f 6e 20 66 61 69 6c | 73 20 61 6e 64 20 79 6f |ion fail|s and yo|
|000015f0| 75 d5 72 65 20 75 6e 61 | 62 6c 65 20 74 6f 20 63 |u.re una|ble to c|
|00001600| 68 61 6e 67 65 20 70 61 | 6e 65 73 20 6f 72 20 63 |hange pa|nes or c|
|00001610| 6c 69 63 6b 20 4f 4b 2e | 20 0d 4e 6f 74 65 20 74 |lick OK.| .Note t|
|00001620| 68 61 74 20 6d 75 6c 74 | 69 70 61 6e 65 20 64 69 |hat mult|ipane di|
|00001630| 61 6c 6f 67 73 2c 20 6c | 69 6b 65 20 73 69 6d 70 |alogs, l|ike simp|
|00001640| 6c 65 20 64 69 61 6c 6f | 67 73 2c 20 63 61 6e 20 |le dialo|gs, can |
|00001650| 74 61 6b 65 20 6f 6e 65 | 20 6f 66 20 74 68 72 65 |take one| of thre|
|00001660| 65 20 66 6f 72 6d 73 3a | 20 0d a5 09 73 74 61 6e |e forms:| ...stan|
|00001670| 64 61 72 64 20 6d 6f 64 | 61 6c 20 64 69 61 6c 6f |dard mod|al dialo|
|00001680| 67 20 d1 20 61 20 64 69 | 61 6c 6f 67 20 74 68 61 |g . a di|alog tha|
|00001690| 74 20 68 61 73 20 61 20 | 62 6f 72 64 65 72 20 61 |t has a |border a|
|000016a0| 72 6f 75 6e 64 20 69 74 | 20 61 6e 64 20 6e 6f 20 |round it| and no |
|000016b0| 74 69 74 6c 65 20 62 61 | 72 2c 20 74 68 61 74 20 |title ba|r, that |
|000016c0| 63 61 6e d5 74 20 62 65 | 20 6d 6f 76 65 64 20 61 |can.t be| moved a|
|000016d0| 72 6f 75 6e 64 20 6f 6e | 20 74 68 65 20 73 63 72 |round on| the scr|
|000016e0| 65 65 6e 2c 20 61 6e 64 | 20 74 68 61 74 20 73 74 |een, and| that st|
|000016f0| 61 79 73 20 66 72 6f 6e | 74 6d 6f 73 74 20 61 73 |ays fron|tmost as|
|00001700| 20 6c 6f 6e 67 20 61 73 | 20 69 74 d5 73 20 6f 70 | long as| it.s op|
|00001710| 65 6e 0d a5 09 6d 6f 76 | 61 62 6c 65 20 6d 6f 64 |en...mov|able mod|
|00001720| 61 6c 20 64 69 61 6c 6f | 67 20 d1 20 61 20 64 69 |al dialo|g . a di|
|00001730| 61 6c 6f 67 20 74 68 61 | 74 20 68 61 73 20 61 20 |alog tha|t has a |
|00001740| 62 6f 72 64 65 72 20 61 | 72 6f 75 6e 64 20 69 74 |border a|round it|
|00001750| 20 61 6e 64 20 61 20 74 | 69 74 6c 65 20 62 61 72 | and a t|itle bar|
|00001760| 2c 20 74 68 61 74 20 63 | 61 6e 20 62 65 20 6d 6f |, that c|an be mo|
|00001770| 76 65 64 20 61 72 6f 75 | 6e 64 20 6f 6e 20 74 68 |ved arou|nd on th|
|00001780| 65 20 73 63 72 65 65 6e | 2c 20 61 6e 64 20 74 68 |e screen|, and th|
|00001790| 61 74 20 73 74 61 79 73 | 20 66 72 6f 6e 74 6d 6f |at stays| frontmo|
|000017a0| 73 74 20 61 73 20 6c 6f | 6e 67 20 61 73 20 69 74 |st as lo|ng as it|
|000017b0| d5 73 20 6f 70 65 6e 20 | 61 6e 64 20 74 68 65 20 |.s open |and the |
|000017c0| 61 70 70 6c 69 63 61 74 | 69 6f 6e 20 69 73 20 66 |applicat|ion is f|
|000017d0| 72 6f 6e 74 6d 6f 73 74 | 20 0d a5 09 6d 6f 64 65 |rontmost| ...mode|
|000017e0| 6c 65 73 73 20 64 69 61 | 6c 6f 67 20 d1 20 61 20 |less dia|log . a |
|000017f0| 64 69 61 6c 6f 67 20 74 | 68 61 74 20 6c 6f 6f 6b |dialog t|hat look|
|00001800| 73 20 61 6e 64 20 62 65 | 68 61 76 65 73 20 6c 69 |s and be|haves li|
|00001810| 6b 65 20 61 20 6e 6f 72 | 6d 61 6c 20 64 6f 63 75 |ke a nor|mal docu|
|00001820| 6d 65 6e 74 20 77 69 6e | 64 6f 77 20 77 69 74 68 |ment win|dow with|
|00001830| 20 61 20 74 69 74 6c 65 | 20 62 61 72 20 61 6e 64 | a title| bar and|
|00001840| 20 61 20 63 6c 6f 73 65 | 20 62 6f 78 2c 20 61 6e | a close| box, an|
|00001850| 64 20 74 68 61 74 20 69 | 73 6e d5 74 20 61 6c 77 |d that i|sn.t alw|
|00001860| 61 79 73 20 66 72 6f 6e | 74 6d 6f 73 74 0d 54 68 |ays fron|tmost.Th|
|00001870| 65 20 73 61 6d 70 6c 65 | 20 70 72 6f 67 72 61 6d |e sample| program|
|00001880| 20 64 69 73 70 6c 61 79 | 73 20 61 20 6d 6f 76 61 | display|s a mova|
|00001890| 62 6c 65 20 6d 6f 64 61 | 6c 20 64 69 61 6c 6f 67 |ble moda|l dialog|
|000018a0| 2c 20 62 75 74 20 74 68 | 65 20 63 6f 64 65 20 70 |, but th|e code p|
|000018b0| 72 6f 76 69 64 65 64 20 | 73 75 70 70 6f 72 74 73 |rovided |supports|
|000018c0| 20 61 6c 6c 20 74 68 72 | 65 65 20 66 6f 72 6d 73 | all thr|ee forms|
|000018d0| 2e 20 0d 54 68 61 74 d5 | 73 20 61 6c 6c 20 74 68 |. .That.|s all th|
|000018e0| 65 72 65 20 69 73 20 74 | 6f 20 74 68 65 20 69 6e |ere is t|o the in|
|000018f0| 74 65 72 66 61 63 65 2e | 20 46 6f 72 20 73 6f 6d |terface.| For som|
|00001900| 65 20 77 6f 72 64 73 20 | 6f 66 20 77 69 73 64 6f |e words |of wisdo|
|00001910| 6d 20 61 62 6f 75 74 20 | 74 68 69 6e 67 73 20 74 |m about |things t|
|00001920| 6f 20 74 61 6b 65 20 69 | 6e 74 6f 20 61 63 63 6f |o take i|nto acco|
|00001930| 75 6e 74 20 61 73 20 79 | 6f 75 20 64 65 73 69 67 |unt as y|ou desig|
|00001940| 6e 20 79 6f 75 72 20 6f | 77 6e 20 6d 75 6c 74 69 |n your o|wn multi|
|00001950| 70 61 6e 65 20 64 69 61 | 6c 6f 67 73 2c 20 73 65 |pane dia|logs, se|
|00001960| 65 20 d2 54 69 70 73 20 | 66 6f 72 20 44 65 73 69 |e .Tips |for Desi|
|00001970| 67 6e 69 6e 67 20 4d 75 | 6c 74 69 70 61 6e 65 20 |gning Mu|ltipane |
|00001980| 44 69 61 6c 6f 67 73 2e | d3 20 4e 6f 77 20 77 65 |Dialogs.|. Now we|
|00001990| d5 6c 6c 20 6d 6f 76 65 | 20 61 6c 6f 6e 67 20 74 |.ll move| along t|
|000019a0| 6f 20 74 68 65 20 64 65 | 74 61 69 6c 73 20 6f 66 |o the de|tails of|
|000019b0| 20 68 6f 77 20 74 6f 20 | 69 6e 63 6f 72 70 6f 72 | how to |incorpor|
|000019c0| 61 74 65 20 74 68 65 20 | 6d 75 6c 74 69 70 61 6e |ate the |multipan|
|000019d0| 65 20 64 69 61 6c 6f 67 | 20 72 6f 75 74 69 6e 65 |e dialog| routine|
|000019e0| 73 20 6f 6e 20 74 68 65 | 20 43 44 20 69 6e 74 6f |s on the| CD into|
|000019f0| 20 79 6f 75 72 20 6f 77 | 6e 20 61 70 70 6c 69 63 | your ow|n applic|
|00001a00| 61 74 69 6f 6e 3a 20 74 | 68 65 20 72 65 73 6f 75 |ation: t|he resou|
|00001a10| 72 63 65 73 20 79 6f 75 | 20 6e 65 65 64 20 74 6f |rces you| need to|
|00001a20| 20 64 65 66 69 6e 65 2c | 20 74 68 65 20 63 61 6c | define,| the cal|
|00001a30| 6c 73 20 74 6f 20 6d 61 | 6b 65 20 74 6f 20 74 68 |ls to ma|ke to th|
|00001a40| 65 20 6d 61 69 6e 20 72 | 6f 75 74 69 6e 65 73 20 |e main r|outines |
|00001a50| 74 6f 20 6f 70 65 6e 20 | 74 68 65 20 64 69 61 6c |to open |the dial|
|00001a60| 6f 67 20 61 6e 64 20 68 | 61 6e 64 6c 65 20 65 76 |og and h|andle ev|
|00001a70| 65 6e 74 73 2c 20 61 6e | 64 20 74 68 65 20 63 75 |ents, an|d the cu|
|00001a80| 73 74 6f 6d 69 7a 69 6e | 67 20 79 6f 75 20 63 61 |stomizin|g you ca|
|00001a90| 6e 20 64 6f 20 77 69 74 | 68 20 6f 70 74 69 6f 6e |n do wit|h option|
|00001aa0| 61 6c 20 70 72 6f 63 65 | 64 75 72 65 73 2e 0d 54 |al proce|dures..T|
|00001ab0| 49 50 53 20 46 4f 52 20 | 44 45 53 49 47 4e 49 4e |IPS FOR |DESIGNIN|
|00001ac0| 47 20 4d 55 4c 54 49 50 | 41 4e 45 20 44 49 41 4c |G MULTIP|ANE DIAL|
|00001ad0| 4f 47 53 0d 62 79 20 45 | 6c 69 7a 61 62 65 74 68 |OGS.by E|lizabeth|
|00001ae0| 20 4d 6f 6c 6c 65 72 20 | 4f 46 20 41 70 70 6c 65 | Moller |OF Apple|
|00001af0| d5 53 20 48 75 6d 61 6e | 20 49 6e 74 65 72 66 61 |.S Human| Interfa|
|00001b00| 63 65 20 44 65 73 69 67 | 6e 20 43 65 6e 74 65 72 |ce Desig|n Center|
|00001b10| 09 09 0d 41 20 6d 75 6c | 74 69 70 61 6e 65 20 64 |...A mul|tipane d|
|00001b20| 69 61 6c 6f 67 20 69 73 | 20 61 70 70 72 6f 70 72 |ialog is| appropr|
|00001b30| 69 61 74 65 20 6f 6e 6c | 79 20 77 68 65 6e 20 74 |iate onl|y when t|
|00001b40| 68 65 20 70 61 6e 65 73 | 20 79 6f 75 d5 72 65 20 |he panes| you.re |
|00001b50| 70 72 65 73 65 6e 74 69 | 6e 67 20 61 72 65 20 6f |presenti|ng are o|
|00001b60| 62 76 69 6f 75 73 6c 79 | 20 72 65 6c 61 74 65 64 |bviously| related|
|00001b70| 20 74 6f 20 6f 6e 65 20 | 61 6e 6f 74 68 65 72 20 | to one |another |
|00001b80| 69 6e 20 73 6f 6d 65 20 | 77 61 79 2e 20 57 69 74 |in some |way. Wit|
|00001b90| 68 20 74 68 61 74 20 63 | 61 76 65 61 74 20 69 6e |h that c|aveat in|
|00001ba0| 20 6d 69 6e 64 2c 20 68 | 65 72 65 20 61 72 65 20 | mind, h|ere are |
|00001bb0| 73 6f 6d 65 20 73 75 67 | 67 65 73 74 69 6f 6e 73 |some sug|gestions|
|00001bc0| 20 66 6f 72 20 6d 61 6b | 69 6e 67 20 79 6f 75 72 | for mak|ing your|
|00001bd0| 20 6d 75 6c 74 69 70 61 | 6e 65 20 64 69 61 6c 6f | multipa|ne dialo|
|00001be0| 67 73 20 65 61 73 79 20 | 74 6f 20 75 6e 64 65 72 |gs easy |to under|
|00001bf0| 73 74 61 6e 64 20 61 6e | 64 20 75 73 65 3a 0d a5 |stand an|d use:..|
|00001c00| 09 50 72 6f 76 69 64 65 | 20 61 20 73 65 6e 74 65 |.Provide| a sente|
|00001c10| 6e 63 65 20 6f 72 20 74 | 69 74 6c 65 20 74 6f 20 |nce or t|itle to |
|00001c20| 68 65 6c 70 20 63 6c 61 | 72 69 66 79 20 79 6f 75 |help cla|rify you|
|00001c30| 72 20 69 6e 74 65 6e 74 | 2e 20 46 6f 72 20 65 78 |r intent|. For ex|
|00001c40| 61 6d 70 6c 65 2c 20 79 | 6f 75 20 6d 69 67 68 74 |ample, y|ou might|
|00001c50| 20 70 72 65 63 65 64 65 | 20 61 20 73 63 72 6f 6c | precede| a scrol|
|00001c60| 6c 69 6e 67 20 6c 69 73 | 74 20 6f 66 20 69 63 6f |ling lis|t of ico|
|00001c70| 6e 73 20 69 6e 20 61 20 | 70 72 65 66 65 72 65 6e |ns in a |preferen|
|00001c80| 63 65 73 20 64 69 61 6c | 6f 67 20 77 69 74 68 20 |ces dial|og with |
|00001c90| 61 20 73 65 6e 74 65 6e | 63 65 20 6c 69 6b 65 20 |a senten|ce like |
|00001ca0| d2 53 65 6c 65 63 74 20 | 69 74 65 6d 73 20 66 72 |.Select |items fr|
|00001cb0| 6f 6d 20 74 68 69 73 20 | 6c 69 73 74 20 74 6f 20 |om this |list to |
|00001cc0| 73 65 74 20 79 6f 75 72 | 20 53 75 72 66 57 72 69 |set your| SurfWri|
|00001cd0| 74 65 72 20 70 72 65 66 | 65 72 65 6e 63 65 73 2e |ter pref|erences.|
|00001ce0| d3 0d a5 09 49 66 20 79 | 6f 75 20 75 73 65 20 61 |....If y|ou use a|
|00001cf0| 6e 20 69 63 6f 6e 20 6c | 69 73 74 2c 20 6c 61 62 |n icon l|ist, lab|
|00001d00| 65 6c 20 74 68 65 20 69 | 63 6f 6e 73 20 69 6e 20 |el the i|cons in |
|00001d10| 79 6f 75 72 20 6c 69 73 | 74 20 74 6f 20 68 65 6c |your lis|t to hel|
|00001d20| 70 20 75 73 65 72 73 20 | 72 65 63 6f 67 6e 69 7a |p users |recogniz|
|00001d30| 65 20 74 68 65 6d 2e 0d | a5 09 56 69 73 75 61 6c |e them..|..Visual|
|00001d40| 6c 79 20 73 65 70 61 72 | 61 74 65 20 62 75 74 74 |ly separ|ate butt|
|00001d50| 6f 6e 73 20 74 68 61 74 | 20 61 70 70 6c 79 20 6f |ons that| apply o|
|00001d60| 6e 6c 79 20 74 6f 20 74 | 68 65 20 63 75 72 72 65 |nly to t|he curre|
|00001d70| 6e 74 20 70 61 6e 65 20 | 66 72 6f 6d 20 74 68 6f |nt pane |from tho|
|00001d80| 73 65 20 74 68 61 74 20 | 77 6f 72 6b 20 6f 6e 20 |se that |work on |
|00001d90| 61 6c 6c 20 70 61 6e 65 | 73 20 28 6c 69 6b 65 20 |all pane|s (like |
|00001da0| 4f 4b 20 61 6e 64 20 43 | 61 6e 63 65 6c 20 69 6e |OK and C|ancel in|
|00001db0| 20 61 20 6d 6f 64 61 6c | 20 64 69 61 6c 6f 67 29 | a modal| dialog)|
|00001dc0| 2e 0d a5 09 44 6f 6e d5 | 74 20 63 68 61 6e 67 65 |....Don.|t change|
|00001dd0| 20 74 68 65 20 73 69 7a | 65 20 6f 66 20 74 68 65 | the siz|e of the|
|00001de0| 20 64 69 61 6c 6f 67 20 | 6f 72 20 77 69 6e 64 6f | dialog |or windo|
|00001df0| 77 20 61 73 20 74 68 65 | 20 75 73 65 72 20 6e 61 |w as the| user na|
|00001e00| 76 69 67 61 74 65 73 20 | 66 72 6f 6d 20 70 61 6e |vigates |from pan|
|00001e10| 65 20 74 6f 20 70 61 6e | 65 2e 20 50 69 63 6b 20 |e to pan|e. Pick |
|00001e20| 61 20 73 69 7a 65 20 74 | 68 61 74 20 61 63 63 6f |a size t|hat acco|
|00001e30| 6d 6d 6f 64 61 74 65 73 | 20 74 68 65 20 70 61 6e |mmodates| the pan|
|00001e40| 65 20 77 69 74 68 20 74 | 68 65 20 6d 6f 73 74 20 |e with t|he most |
|00001e50| 63 6f 6e 74 72 6f 6c 73 | 2e 0d a5 09 44 65 73 69 |controls|....Desi|
|00001e60| 67 6e 20 74 68 65 20 64 | 69 61 6c 6f 67 20 73 6f |gn the d|ialog so|
|00001e70| 20 74 68 61 74 20 63 68 | 61 6e 67 69 6e 67 20 74 | that ch|anging t|
|00001e80| 68 65 20 73 65 74 74 69 | 6e 67 73 20 69 6e 20 6f |he setti|ngs in o|
|00001e90| 6e 65 20 70 61 6e 65 20 | 64 6f 65 73 6e d5 74 20 |ne pane |doesn.t |
|00001ea0| 63 68 61 6e 67 65 20 74 | 68 65 20 73 65 74 74 69 |change t|he setti|
|00001eb0| 6e 67 73 20 69 6e 20 61 | 6e 6f 74 68 65 72 2e 20 |ngs in a|nother. |
|00001ec0| 46 6f 72 20 09 09 65 78 | 61 6d 70 6c 65 2c 20 63 |For ..ex|ample, c|
|00001ed0| 6c 69 63 6b 69 6e 67 20 | 61 20 63 68 65 63 6b 62 |licking |a checkb|
|00001ee0| 6f 78 20 69 6e 20 6f 6e | 65 20 70 61 6e 65 20 73 |ox in on|e pane s|
|00001ef0| 68 6f 75 6c 64 6e d5 74 | 20 64 69 73 61 62 6c 65 |houldn.t| disable|
|00001f00| 20 61 20 63 68 65 63 6b | 62 6f 78 20 69 6e 20 61 | a check|box in a|
|00001f10| 6e 6f 74 68 65 72 20 70 | 61 6e 65 2c 20 62 65 63 |nother p|ane, bec|
|00001f20| 61 75 73 65 20 74 68 65 | 20 75 73 65 72 20 77 6f |ause the| user wo|
|00001f30| 6e d5 74 20 73 65 65 20 | 74 68 65 20 6c 61 74 74 |n.t see |the latt|
|00001f40| 65 72 20 61 63 74 69 6f | 6e 20 6f 63 63 75 72 20 |er actio|n occur |
|00001f50| 61 6e 64 20 74 68 75 73 | 20 77 6f 6e d5 74 20 75 |and thus| won.t u|
|00001f60| 6e 64 65 72 73 74 61 6e | 64 20 74 68 65 20 63 61 |nderstan|d the ca|
|00001f70| 75 73 65 20 61 6e 64 20 | 65 66 66 65 63 74 2e 0d |use and |effect..|
|00001f80| a5 09 42 65 20 63 6f 6e | 73 69 73 74 65 6e 74 20 |..Be con|sistent |
|00001f90| 69 6e 20 79 6f 75 72 20 | 75 73 65 20 6f 66 20 63 |in your |use of c|
|00001fa0| 6f 6e 74 72 6f 6c 73 2e | 20 49 66 20 79 6f 75 20 |ontrols.| If you |
|00001fb0| 75 73 65 20 61 20 70 61 | 72 74 69 63 75 6c 61 72 |use a pa|rticular|
|00001fc0| 20 74 79 70 65 20 6f 66 | 20 63 6f 6e 74 72 6f 6c | type of| control|
|00001fd0| 20 74 6f 20 6d 65 61 6e | 20 d2 63 68 6f 6f 73 65 | to mean| .choose|
|00001fe0| 20 61 20 73 65 74 74 69 | 6e 67 2c d3 20 66 6f 72 | a setti|ng,. for|
|00001ff0| 20 69 6e 73 74 61 6e 63 | 65 2c 20 64 6f 6e d5 74 | instanc|e, don.t|
|00002000| 20 75 73 65 20 74 68 65 | 20 73 61 6d 65 20 74 79 | use the| same ty|
|00002010| 70 65 20 6f 66 20 63 6f | 6e 74 72 6f 6c 20 74 6f |pe of co|ntrol to|
|00002020| 20 6d 65 61 6e 20 d2 6e | 61 76 69 67 61 74 65 20 | mean .n|avigate |
|00002030| 62 65 74 77 65 65 6e 20 | 70 61 6e 65 73 d3 20 69 |between |panes. i|
|00002040| 6e 20 74 68 65 20 73 61 | 6d 65 20 64 69 61 6c 6f |n the sa|me dialo|
|00002050| 67 2e 20 55 73 65 72 73 | 20 73 68 6f 75 6c 64 20 |g. Users| should |
|00002060| 62 65 20 61 62 6c 65 20 | 74 6f 20 65 61 73 69 6c |be able |to easil|
|00002070| 79 20 64 69 73 74 69 6e | 67 75 69 73 68 20 63 6f |y distin|guish co|
|00002080| 6e 74 72 6f 6c 73 20 74 | 68 61 74 20 6e 61 76 69 |ntrols t|hat navi|
|00002090| 67 61 74 65 20 74 68 72 | 6f 75 67 68 20 6d 75 6c |gate thr|ough mul|
|000020a0| 74 69 70 6c 65 20 70 61 | 6e 65 73 20 66 72 6f 6d |tiple pa|nes from|
|000020b0| 20 63 6f 6e 74 72 6f 6c | 73 20 74 68 61 74 20 6d | control|s that m|
|000020c0| 61 6b 65 20 63 68 6f 69 | 63 65 73 20 69 6e 20 74 |ake choi|ces in t|
|000020d0| 68 65 20 64 69 61 6c 6f | 67 2e 0d a5 09 4f 72 64 |he dialo|g....Ord|
|000020e0| 65 72 20 74 68 65 20 70 | 61 6e 65 73 20 66 72 6f |er the p|anes fro|
|000020f0| 6d 20 6d 61 6e 64 61 74 | 6f 72 79 20 74 6f 20 6f |m mandat|ory to o|
|00002100| 70 74 69 6f 6e 61 6c 2c | 20 62 79 20 66 72 65 71 |ptional,| by freq|
|00002110| 75 65 6e 63 79 20 6f 66 | 20 75 73 65 2c 20 66 72 |uency of| use, fr|
|00002120| 6f 6d 20 67 65 6e 65 72 | 61 6c 20 74 6f 20 73 70 |om gener|al to sp|
|00002130| 65 63 69 66 69 63 2c 20 | 6f 72 2c 20 77 68 65 6e |ecific, |or, when|
|00002140| 20 6e 6f 20 6f 74 68 65 | 72 20 6f 72 64 65 72 20 | no othe|r order |
|00002150| 69 73 20 61 70 70 61 72 | 65 6e 74 2c 20 61 6c 70 |is appar|ent, alp|
|00002160| 68 61 62 65 74 69 63 61 | 6c 6c 79 2e 20 49 66 20 |habetica|lly. If |
|00002170| 74 68 65 72 65 20 61 72 | 65 20 6d 61 6e 64 61 74 |there ar|e mandat|
|00002180| 6f 72 79 20 66 69 65 6c | 64 73 20 61 6e 64 20 63 |ory fiel|ds and c|
|00002190| 6f 6e 74 72 6f 6c 73 2c | 20 62 65 20 73 75 72 65 |ontrols,| be sure|
|000021a0| 20 74 6f 20 70 75 74 20 | 74 68 65 6d 20 69 6e 20 | to put |them in |
|000021b0| 74 68 65 20 66 69 72 73 | 74 20 70 61 6e 65 20 6f |the firs|t pane o|
|000021c0| 72 20 73 74 65 70 20 74 | 68 65 20 75 73 65 72 20 |r step t|he user |
|000021d0| 74 68 72 6f 75 67 68 20 | 6d 61 6e 64 61 74 6f 72 |through |mandator|
|000021e0| 79 20 70 61 6e 65 73 20 | 62 65 66 6f 72 65 20 6f |y panes |before o|
|000021f0| 70 74 69 6f 6e 61 6c 20 | 6f 6e 65 73 2e 0d a5 09 |ptional |ones....|
|00002200| 57 68 65 6e 20 74 68 65 | 20 64 69 61 6c 6f 67 20 |When the| dialog |
|00002210| 69 73 20 63 6c 6f 73 65 | 64 2c 20 72 65 6d 65 6d |is close|d, remem|
|00002220| 62 65 72 20 74 68 65 20 | 70 61 6e 65 20 74 68 61 |ber the |pane tha|
|00002230| 74 20 77 61 73 20 6c 61 | 73 74 20 75 73 65 64 2c |t was la|st used,|
|00002240| 20 75 6e 6c 65 73 73 20 | 74 68 65 72 65 20 61 72 | unless |there ar|
|00002250| 65 20 6d 61 6e 64 61 74 | 6f 72 79 20 63 6f 6e 74 |e mandat|ory cont|
|00002260| 72 6f 6c 73 20 69 6e 20 | 61 20 70 61 6e 65 2e 20 |rols in |a pane. |
|00002270| 49 66 20 74 68 65 72 65 | 20 69 73 20 61 20 6d 61 |If there| is a ma|
|00002280| 6e 64 61 74 6f 72 79 20 | 70 61 6e 65 2c 20 69 74 |ndatory |pane, it|
|00002290| 20 73 68 6f 75 6c 64 20 | 61 6c 77 61 79 73 20 62 | should |always b|
|000022a0| 65 20 64 69 73 70 6c 61 | 79 65 64 20 77 68 65 6e |e displa|yed when|
|000022b0| 20 74 68 65 20 64 69 61 | 6c 6f 67 20 72 65 6f 70 | the dia|log reop|
|000022c0| 65 6e 73 2e 0d 09 0d 44 | 45 46 49 4e 49 4e 47 20 |ens....D|EFINING |
|000022d0| 4e 45 45 44 45 44 20 52 | 45 53 4f 55 52 43 45 53 |NEEDED R|ESOURCES|
|000022e0| 0d 54 68 65 20 66 69 72 | 73 74 20 73 74 65 70 20 |.The fir|st step |
|000022f0| 69 6e 20 69 6e 63 6f 72 | 70 6f 72 61 74 69 6e 67 |in incor|porating|
|00002300| 20 74 68 65 20 6d 75 6c | 74 69 70 61 6e 65 20 64 | the mul|tipane d|
|00002310| 69 61 6c 6f 67 20 72 6f | 75 74 69 6e 65 73 20 69 |ialog ro|utines i|
|00002320| 73 20 74 6f 20 64 65 66 | 69 6e 65 20 74 68 65 20 |s to def|ine the |
|00002330| 63 75 73 74 6f 6d 20 72 | 65 73 6f 75 72 63 65 73 |custom r|esources|
|00002340| 20 74 68 65 20 63 6f 64 | 65 20 6e 65 65 64 73 2e | the cod|e needs.|
|00002350| 20 59 6f 75 d5 6c 6c 20 | 66 69 6e 64 20 52 65 73 | You.ll |find Res|
|00002360| 45 64 69 74 20 54 4d 50 | 4c 20 74 65 6d 70 6c 61 |Edit TMP|L templa|
|00002370| 74 65 73 20 66 6f 72 20 | 61 6c 6c 20 74 68 65 20 |tes for |all the |
|00002380| 6e 65 65 64 65 64 20 72 | 65 73 6f 75 72 63 65 73 |needed r|esources|
|00002390| 20 6f 6e 20 74 68 65 20 | 43 44 2e 20 59 6f 75 20 | on the |CD. You |
|000023a0| 63 61 6e 20 70 75 74 20 | 74 68 65 73 65 20 69 6e |can put |these in|
|000023b0| 20 74 68 65 20 52 65 73 | 45 64 69 74 20 50 72 65 | the Res|Edit Pre|
|000023c0| 66 65 72 65 6e 63 65 73 | 20 66 69 6c 65 20 74 6f |ferences| file to|
|000023d0| 20 6d 61 6b 65 20 74 68 | 65 6d 20 61 76 61 69 6c | make th|em avail|
|000023e0| 61 62 6c 65 20 61 74 20 | 61 6c 6c 20 74 69 6d 65 |able at |all time|
|000023f0| 73 20 6f 72 20 6c 65 61 | 76 65 20 74 68 65 6d 20 |s or lea|ve them |
|00002400| 69 6e 20 74 68 65 20 61 | 70 70 6c 69 63 61 74 69 |in the a|pplicati|
|00002410| 6f 6e 20 79 6f 75 d5 72 | 65 20 65 64 69 74 69 6e |on you.r|e editin|
|00002420| 67 2e 0d 54 68 65 20 66 | 69 72 73 74 20 72 65 73 |g..The f|irst res|
|00002430| 6f 75 72 63 65 20 74 68 | 61 74 20 6e 65 65 64 73 |ource th|at needs|
|00002440| 20 74 6f 20 62 65 20 63 | 72 65 61 74 65 64 20 69 | to be c|reated i|
|00002450| 73 20 74 68 65 20 6d 61 | 69 6e 20 44 4c 4f 47 20 |s the ma|in DLOG |
|00002460| 61 6e 64 20 69 74 73 20 | 61 73 73 6f 63 69 61 74 |and its |associat|
|00002470| 65 64 20 44 49 54 4c 2c | 20 77 68 69 63 68 20 77 |ed DITL,| which w|
|00002480| 69 6c 6c 20 66 6f 72 6d | 20 74 68 65 20 62 61 73 |ill form| the bas|
|00002490| 69 73 20 66 6f 72 20 74 | 68 65 20 64 69 61 6c 6f |is for t|he dialo|
|000024a0| 67 2e 20 41 20 73 61 6d | 70 6c 65 20 69 73 20 70 |g. A sam|ple is p|
|000024b0| 72 6f 76 69 64 65 64 20 | 69 6e 20 74 68 65 20 66 |rovided |in the f|
|000024c0| 69 6c 65 20 4d 50 44 69 | 61 6c 6f 67 73 20 52 65 |ile MPDi|alogs Re|
|000024d0| 73 6f 75 72 63 65 73 20 | 74 68 61 74 20 79 6f 75 |sources |that you|
|000024e0| 20 63 61 6e 20 73 69 6d | 70 6c 79 20 63 6f 70 79 | can sim|ply copy|
|000024f0| 20 69 6e 74 6f 20 61 20 | 6e 65 77 20 70 72 6f 6a | into a |new proj|
|00002500| 65 63 74 d5 73 20 72 65 | 73 6f 75 72 63 65 20 66 |ect.s re|source f|
|00002510| 69 6c 65 2e 20 54 68 65 | 20 44 49 54 4c 20 73 68 |ile. The| DITL sh|
|00002520| 6f 75 6c 64 20 69 6e 63 | 6c 75 64 65 20 73 69 78 |ould inc|lude six|
|00002530| 20 69 74 65 6d 73 2c 20 | 6e 75 6d 62 65 72 65 64 | items, |numbered|
|00002540| 20 61 73 20 66 6f 6c 6c | 6f 77 73 3a 0d 31 2e 09 | as foll|ows:.1..|
|00002550| 4f 4b 20 62 75 74 74 6f | 6e 0d 32 2e 09 43 61 6e |OK butto|n.2..Can|
|00002560| 63 65 6c 20 62 75 74 74 | 6f 6e 0d 33 2e 09 52 65 |cel butt|on.3..Re|
|00002570| 76 65 72 74 20 62 75 74 | 74 6f 6e 0d 34 2e 09 55 |vert but|ton.4..U|
|00002580| 73 65 20 44 65 66 61 75 | 6c 74 73 20 62 75 74 74 |se Defau|lts butt|
|00002590| 6f 6e 0d 35 2e 09 61 20 | 75 73 65 72 20 69 74 65 |on.5..a |user ite|
|000025a0| 6d 20 74 68 61 74 20 64 | 65 66 69 6e 65 73 20 74 |m that d|efines t|
|000025b0| 68 65 20 69 63 6f 6e 20 | 6c 69 73 74 20 72 65 63 |he icon |list rec|
|000025c0| 74 61 6e 67 6c 65 0d 36 | 2e 09 61 20 68 69 64 64 |tangle.6|..a hidd|
|000025d0| 65 6e 20 73 74 61 74 69 | 63 20 74 65 78 74 20 66 |en stati|c text f|
|000025e0| 69 65 6c 64 20 66 6f 72 | 20 64 65 66 61 75 6c 74 |ield for| default|
|000025f0| 20 43 6f 6d 6d 61 6e 64 | 2d 6b 65 79 20 65 71 75 | Command|-key equ|
|00002600| 69 76 61 6c 65 6e 74 73 | 0d 54 68 65 20 52 65 76 |ivalents|.The Rev|
|00002610| 65 72 74 20 61 6e 64 20 | 55 73 65 20 44 65 66 61 |ert and |Use Defa|
|00002620| 75 6c 74 73 20 62 75 74 | 74 6f 6e 73 20 63 61 6e |ults but|tons can|
|00002630| 20 62 65 20 6d 6f 76 65 | 64 20 6f 66 66 73 63 72 | be move|d offscr|
|00002640| 65 65 6e 20 74 6f 20 6d | 61 6b 65 20 65 69 74 68 |een to m|ake eith|
|00002650| 65 72 20 6f 66 20 74 68 | 65 6d 20 75 6e 61 76 61 |er of th|em unava|
|00002660| 69 6c 61 62 6c 65 2e 20 | 28 54 68 65 20 73 61 6d |ilable. |(The sam|
|00002670| 70 6c 65 20 63 6f 64 65 | 20 64 6f 65 73 6e d5 74 |ple code| doesn.t|
|00002680| 20 72 65 61 6c 6c 79 20 | 63 61 72 65 20 77 68 65 | really |care whe|
|00002690| 74 68 65 72 20 79 6f 75 | 20 61 63 68 69 65 76 65 |ther you| achieve|
|000026a0| 20 74 68 69 73 20 62 79 | 20 6d 6f 76 69 6e 67 20 | this by| moving |
|000026b0| 74 68 65 20 62 75 74 74 | 6f 6e 73 20 6f 75 74 20 |the butt|ons out |
|000026c0| 6f 66 20 74 68 65 20 76 | 69 73 69 62 6c 65 20 70 |of the v|isible p|
|000026d0| 6f 72 74 69 6f 6e 20 6f | 66 20 74 68 65 20 64 69 |ortion o|f the di|
|000026e0| 61 6c 6f 67 20 6f 72 20 | 62 79 20 6d 61 6b 69 6e |alog or |by makin|
|000026f0| 67 20 74 68 65 20 72 65 | 63 74 61 6e 67 6c 65 20 |g the re|ctangle |
|00002700| 73 69 7a 65 20 6e 75 6c | 6c 2e 20 41 6c 74 65 72 |size nul|l. Alter|
|00002710| 6e 61 74 65 6c 79 2c 20 | 74 68 65 20 62 75 74 74 |nately, |the butt|
|00002720| 6f 6e 73 20 63 61 6e 20 | 62 65 20 72 65 6d 6f 76 |ons can |be remov|
|00002730| 65 64 20 61 6e 64 20 74 | 68 65 20 63 6f 6e 74 72 |ed and t|he contr|
|00002740| 6f 6c 20 23 64 65 66 69 | 6e 65 73 20 69 6e 20 74 |ol #defi|nes in t|
|00002750| 68 65 20 6d 61 69 6e 20 | 68 65 61 64 65 72 20 66 |he main |header f|
|00002760| 69 6c 65 2c 20 4d 50 44 | 69 61 6c 6f 67 73 2e 68 |ile, MPD|ialogs.h|
|00002770| 2c 20 63 61 6e 20 62 65 | 20 63 68 61 6e 67 65 64 |, can be| changed|
|00002780| 20 74 6f 20 72 65 66 6c | 65 63 74 20 74 68 65 20 | to refl|ect the |
|00002790| 6e 65 77 20 6e 75 6d 62 | 65 72 69 6e 67 2e 29 20 |new numb|ering.) |
|000027a0| 54 68 65 20 69 63 6f 6e | 20 6c 69 73 74 20 69 73 |The icon| list is|
|000027b0| 20 61 6c 77 61 79 73 20 | 64 69 73 70 6c 61 79 65 | always |displaye|
|000027c0| 64 20 76 65 72 74 69 63 | 61 6c 6c 79 2c 20 61 6e |d vertic|ally, an|
|000027d0| 64 20 74 68 65 20 72 65 | 63 74 61 6e 67 6c 65 20 |d the re|ctangle |
|000027e0| 64 6f 65 73 6e d5 74 20 | 69 6e 63 6c 75 64 65 20 |doesn.t |include |
|000027f0| 74 68 65 20 73 63 72 6f | 6c 6c 20 62 61 72 2e 20 |the scro|ll bar. |
|00002800| 54 68 65 20 0d 43 4f 44 | 45 20 46 4f 52 20 44 49 |The .COD|E FOR DI|
|00002810| 41 4c 4f 47 20 43 4f 4d | 4d 41 4e 44 2d 4b 45 59 |ALOG COM|MAND-KEY|
|00002820| 20 45 51 55 49 56 41 4c | 45 4e 54 53 09 09 0d 54 | EQUIVAL|ENTS...T|
|00002830| 68 65 20 43 6f 6d 6d 61 | 6e 64 2d 6b 65 79 20 65 |he Comma|nd-key e|
|00002840| 71 75 69 76 61 6c 65 6e | 74 20 63 6f 64 65 20 49 |quivalen|t code I|
|00002850| 20 70 72 6f 76 69 64 65 | 20 69 6e 20 74 68 65 20 | provide| in the |
|00002860| 73 61 6d 70 6c 65 20 75 | 73 65 73 20 61 20 6d 6f |sample u|ses a mo|
|00002870| 64 69 66 69 65 64 20 76 | 65 72 73 69 6f 6e 20 6f |dified v|ersion o|
|00002880| 66 20 4b 65 79 45 71 75 | 69 76 46 69 6c 74 65 72 |f KeyEqu|ivFilter|
|00002890| 2c 20 61 20 72 6f 75 74 | 69 6e 65 20 69 6e 20 55 |, a rout|ine in U|
|000028a0| 74 69 6c 69 74 69 65 73 | 2e 63 2c 20 77 68 69 63 |tilities|.c, whic|
|000028b0| 68 20 69 73 20 70 61 72 | 74 20 6f 66 20 44 54 53 |h is par|t of DTS|
|000028c0| 20 4c 69 62 20 6f 6e 20 | 74 68 65 20 43 44 2e 20 | Lib on |the CD. |
|000028d0| 49 74 20 74 61 6b 65 73 | 20 74 68 65 73 65 20 74 |It takes| these t|
|000028e0| 77 6f 20 61 64 64 69 74 | 69 6f 6e 61 6c 20 70 61 |wo addit|ional pa|
|000028f0| 72 61 6d 65 74 65 72 73 | 3a 0d a5 09 54 68 65 20 |rameters|:...The |
|00002900| 49 44 20 6f 66 20 74 68 | 65 20 73 74 61 74 69 63 |ID of th|e static|
|00002910| 20 74 65 78 74 20 69 74 | 65 6d 20 74 68 61 74 20 | text it|em that |
|00002920| 63 6f 6e 74 61 69 6e 73 | 20 74 68 65 20 6d 61 70 |contains| the map|
|00002930| 70 69 6e 67 73 2e 20 4d | 79 20 64 69 61 6c 6f 67 |pings. M|y dialog|
|00002940| 20 63 6f 64 65 20 63 61 | 6c 6c 73 20 74 68 69 73 | code ca|lls this|
|00002950| 20 72 6f 75 74 69 6e 65 | 20 74 77 69 63 65 2c 20 | routine| twice, |
|00002960| 6f 6e 63 65 20 66 6f 72 | 20 74 68 65 20 62 6f 74 |once for| the bot|
|00002970| 74 6f 6d 20 62 75 74 74 | 6f 6e 73 20 61 6e 64 20 |tom butt|ons and |
|00002980| 61 20 73 65 63 6f 6e 64 | 20 74 69 6d 65 20 66 6f |a second| time fo|
|00002990| 72 20 74 68 65 20 69 74 | 65 6d 73 20 69 6e 20 74 |r the it|ems in t|
|000029a0| 68 65 20 70 61 6e 65 2e | 20 0d a5 09 41 6e 20 6f |he pane.| ...An o|
|000029b0| 66 66 73 65 74 20 74 6f | 20 61 64 64 20 74 6f 20 |ffset to| add to |
|000029c0| 74 68 65 20 69 74 65 6d | 20 6e 75 6d 62 65 72 73 |the item| numbers|
|000029d0| 20 77 68 65 6e 20 61 20 | 68 69 74 20 6f 63 63 75 | when a |hit occu|
|000029e0| 72 73 2e 20 54 68 69 73 | 20 61 6c 6c 6f 77 73 20 |rs. This| allows |
|000029f0| 74 68 65 20 63 6f 64 65 | 20 74 6f 20 75 73 65 20 |the code| to use |
|00002a00| 72 65 6c 61 74 69 76 65 | 20 69 74 65 6d 20 6e 75 |relative| item nu|
|00002a10| 6d 62 65 72 69 6e 67 20 | 66 6f 72 20 65 61 73 69 |mbering |for easi|
|00002a20| 65 72 20 73 70 65 63 69 | 66 69 63 61 74 69 6f 6e |er speci|fication|
|00002a30| 20 6f 66 20 43 6f 6d 6d | 61 6e 64 2d 6b 65 79 20 | of Comm|and-key |
|00002a40| 65 71 75 69 76 61 6c 65 | 6e 74 73 20 69 6e 20 70 |equivale|nts in p|
|00002a50| 61 6e 65 73 2e 0d 54 68 | 65 20 73 74 61 74 69 63 |anes..Th|e static|
|00002a60| 20 74 65 78 74 20 69 74 | 65 6d 20 69 73 20 61 6e | text it|em is an|
|00002a70| 20 69 74 65 6d 2d 6d 61 | 74 63 68 20 73 74 72 69 | item-ma|tch stri|
|00002a80| 6e 67 20 74 68 61 74 20 | 66 6f 6c 6c 6f 77 73 20 |ng that |follows |
|00002a90| 74 68 65 20 67 65 6e 65 | 72 61 6c 20 66 6f 72 6d |the gene|ral form|
|00002aa0| 61 74 20 3d 63 78 78 79 | 79 7a 7a 20 6f 72 20 63 |at =cxxy|yzz or c|
|00002ab0| 63 78 78 79 79 7a 7a 2e | 20 54 68 65 20 3d 63 20 |cxxyyzz.| The =c |
|00002ac0| 6d 61 74 63 68 65 73 20 | 74 68 65 20 63 68 61 72 |matches |the char|
|00002ad0| 61 63 74 65 72 20 63 2c | 20 61 6e 64 20 63 63 20 |acter c,| and cc |
|00002ae0| 6d 61 74 63 68 65 73 20 | 74 68 65 20 63 68 61 72 |matches |the char|
|00002af0| 61 63 74 65 72 20 62 79 | 20 69 74 73 20 41 53 43 |acter by| its ASC|
|00002b00| 49 49 20 76 61 6c 75 65 | 2e 20 54 68 65 20 6e 65 |II value|. The ne|
|00002b10| 78 74 20 6e 75 6d 62 65 | 72 2c 20 78 78 20 28 61 |xt numbe|r, xx (a|
|00002b20| 20 66 6c 61 67 20 62 79 | 74 65 20 77 69 74 68 20 | flag by|te with |
|00002b30| 74 68 65 20 62 69 74 73 | 20 73 65 74 20 74 6f 20 |the bits| set to |
|00002b40| 73 70 65 63 69 66 79 20 | 74 68 65 20 6d 6f 64 69 |specify |the modi|
|00002b50| 66 69 65 72 20 6b 65 79 | 73 20 79 6f 75 d5 72 65 |fier key|s you.re|
|00002b60| 20 63 68 65 63 6b 69 6e | 67 20 66 6f 72 29 2c 20 | checkin|g for), |
|00002b70| 69 73 20 6c 6f 67 69 63 | 61 6c 6c 79 20 41 4e 44 |is logic|ally AND|
|00002b80| 65 64 20 77 69 74 68 20 | 74 68 65 20 6d 6f 64 69 |ed with |the modi|
|00002b90| 66 69 65 72 20 66 6c 61 | 67 73 20 66 72 6f 6d 20 |fier fla|gs from |
|00002ba0| 74 68 65 20 6b 65 79 2d | 64 6f 77 6e 20 65 76 65 |the key-|down eve|
|00002bb0| 6e 74 20 61 6e 64 20 63 | 6f 6d 70 61 72 65 64 20 |nt and c|ompared |
|00002bc0| 74 6f 20 79 79 20 28 61 | 20 66 6c 61 67 20 62 79 |to yy (a| flag by|
|00002bd0| 74 65 20 77 69 74 68 20 | 74 68 65 20 62 69 74 73 |te with |the bits|
|00002be0| 20 73 65 74 20 74 6f 20 | 73 70 65 63 69 66 79 20 | set to |specify |
|00002bf0| 74 68 65 20 76 61 6c 75 | 65 73 20 6f 66 20 74 68 |the valu|es of th|
|00002c00| 65 20 6d 6f 64 69 66 69 | 65 72 20 6b 65 79 73 20 |e modifi|er keys |
|00002c10| d1 20 66 6f 72 20 09 65 | 78 61 6d 70 6c 65 2c 20 |. for .e|xample, |
|00002c20| 79 6f 75 20 63 61 6e 20 | 66 6f 72 63 65 20 74 68 |you can |force th|
|00002c30| 65 20 43 6f 6e 74 72 6f | 6c 20 6b 65 79 20 74 6f |e Contro|l key to|
|00002c40| 20 62 65 20 75 70 29 2e | 20 49 66 20 74 68 69 73 | be up).| If this|
|00002c50| 20 63 6f 6d 70 61 72 69 | 73 6f 6e 20 69 73 20 74 | compari|son is t|
|00002c60| 72 75 65 20 61 6e 64 20 | 69 66 20 74 68 65 20 63 |rue and |if the c|
|00002c70| 68 61 72 61 63 74 65 72 | 20 63 20 6d 61 74 63 68 |haracter| c match|
|00002c80| 65 73 20 74 68 65 20 63 | 68 61 72 61 63 74 65 72 |es the c|haracter|
|00002c90| 20 74 68 65 20 75 73 65 | 72 20 74 79 70 65 64 2c | the use|r typed,|
|00002ca0| 20 74 68 65 20 69 74 65 | 6d 20 7a 7a 20 69 73 20 | the ite|m zz is |
|00002cb0| 72 65 74 75 72 6e 65 64 | 20 61 73 20 62 65 69 6e |returned| as bein|
|00002cc0| 67 20 68 69 74 2e 0d 45 | 61 63 68 20 69 74 65 6d |g hit..E|ach item|
|00002cd0| 2d 6d 61 74 63 68 20 73 | 74 72 69 6e 67 20 69 73 |-match s|tring is|
|00002ce0| 20 65 69 67 68 74 20 63 | 68 61 72 61 63 74 65 72 | eight c|haracter|
|00002cf0| 73 20 6c 6f 6e 67 20 61 | 6e 64 20 69 73 20 73 65 |s long a|nd is se|
|00002d00| 70 61 72 61 74 65 64 20 | 66 72 6f 6d 20 6f 74 68 |parated |from oth|
|00002d10| 65 72 20 73 75 63 68 20 | 73 74 72 69 6e 67 73 20 |er such |strings |
|00002d20| 74 68 61 74 20 66 6f 6c | 6c 6f 77 20 62 79 20 61 |that fol|low by a|
|00002d30| 20 63 6f 6d 6d 61 2e 20 | 54 68 65 20 6e 75 6d 62 | comma. |The numb|
|00002d40| 65 72 73 20 69 6e 20 74 | 68 65 20 73 74 72 69 6e |ers in t|he strin|
|00002d50| 67 73 20 61 72 65 20 68 | 65 78 61 64 65 63 69 6d |gs are h|exadecim|
|00002d60| 61 6c 20 61 6e 64 20 63 | 61 73 65 20 69 73 20 73 |al and c|ase is s|
|00002d70| 69 67 6e 69 66 69 63 61 | 6e 74 20 66 6f 72 20 63 |ignifica|nt for c|
|00002d80| 68 61 72 61 63 74 65 72 | 20 6d 61 74 63 68 65 73 |haracter| matches|
|00002d90| 2e 0d 46 6f 72 20 65 78 | 61 6d 70 6c 65 2c 20 74 |..For ex|ample, t|
|00002da0| 68 65 20 68 69 64 64 65 | 6e 20 73 74 61 74 69 63 |he hidde|n static|
|00002db0| 20 74 65 78 74 20 66 69 | 65 6c 64 20 74 68 61 74 | text fi|eld that|
|00002dc0| d5 73 20 63 68 65 63 6b | 65 64 20 66 6f 72 20 65 |.s check|ed for e|
|00002dd0| 61 63 68 20 70 61 6e 65 | 20 69 6e 20 74 68 65 20 |ach pane| in the |
|00002de0| 73 61 6d 70 6c 65 20 61 | 70 70 6c 69 63 61 74 69 |sample a|pplicati|
|00002df0| 6f 6e 20 69 73 0d 3d 2e | 31 39 30 31 30 32 2c 31 |on is.=.|190102,1|
|00002e00| 42 31 39 30 31 30 32 2c | 31 42 31 39 30 30 30 32 |B190102,|1B190002|
|00002e10| 0d 54 68 65 20 66 69 72 | 73 74 20 69 74 65 6d 2d |.The fir|st item-|
|00002e20| 6d 61 74 63 68 20 73 74 | 72 69 6e 67 20 63 68 65 |match st|ring che|
|00002e30| 63 6b 73 20 66 6f 72 20 | 61 20 70 65 72 69 6f 64 |cks for |a period|
|00002e40| 20 61 6e 64 20 66 6f 72 | 20 0d 74 68 65 20 43 6f | and for| .the Co|
|00002e50| 6e 74 72 6f 6c 2c 20 4f | 70 74 69 6f 6e 2c 20 61 |ntrol, O|ption, a|
|00002e60| 6e 64 20 43 6f 6d 6d 61 | 6e 64 20 6b 65 79 73 2e |nd Comma|nd keys.|
|00002e70| 20 49 66 20 6f 6e 6c 79 | 20 74 68 65 20 43 6f 6d | If only| the Com|
|00002e80| 6d 61 6e 64 20 6b 65 79 | 20 68 61 73 20 62 65 65 |mand key| has bee|
|00002e90| 6e 20 70 72 65 73 73 65 | 64 2c 20 69 74 65 6d 20 |n presse|d, item |
|00002ea0| 32 20 69 73 20 72 65 74 | 75 72 6e 65 64 20 61 73 |2 is ret|urned as|
|00002eb0| 20 62 65 69 6e 67 20 68 | 69 74 2e 20 53 69 6d 69 | being h|it. Simi|
|00002ec0| 6c 61 72 6c 79 2c 20 74 | 68 65 20 6e 65 78 74 20 |larly, t|he next |
|00002ed0| 69 74 65 6d 2d 6d 61 74 | 63 68 20 73 74 72 69 6e |item-mat|ch strin|
|00002ee0| 67 20 68 61 6e 64 6c 65 | 73 20 43 6f 6d 6d 61 6e |g handle|s Comman|
|00002ef0| 64 2d 45 73 63 61 70 65 | 20 28 45 73 63 61 70 65 |d-Escape| (Escape|
|00002f00| 20 69 73 20 31 42 29 20 | 61 6e 64 20 74 68 65 20 | is 1B) |and the |
|00002f10| 6c 61 73 74 20 69 74 65 | 6d 2d 6d 61 74 63 68 20 |last ite|m-match |
|00002f20| 73 74 72 69 6e 67 20 68 | 61 6e 64 6c 65 73 20 45 |string h|andles E|
|00002f30| 73 63 61 70 65 20 62 79 | 20 69 74 73 65 6c 66 2e |scape by| itself.|
|00002f40| 20 0d 09 0d 73 61 6d 70 | 6c 65 20 61 70 70 6c 69 | ...samp|le appli|
|00002f50| 63 61 74 69 6f 6e 20 70 | 72 6f 76 69 64 65 73 20 |cation p|rovides |
|00002f60| 74 68 65 20 73 74 61 6e | 64 61 72 64 20 43 6f 6d |the stan|dard Com|
|00002f70| 6d 61 6e 64 2d 6b 65 79 | 20 65 71 75 69 76 61 6c |mand-key| equival|
|00002f80| 65 6e 74 73 20 66 6f 72 | 20 4f 4b 20 61 6e 64 20 |ents for| OK and |
|00002f90| 43 61 6e 63 65 6c 2e 20 | 54 68 65 20 73 74 61 6e |Cancel. |The stan|
|00002fa0| 64 61 72 64 20 65 71 75 | 69 76 61 6c 65 6e 74 73 |dard equ|ivalents|
|00002fb0| 20 66 6f 72 20 4f 4b 20 | 61 72 65 20 68 61 6e 64 | for OK |are hand|
|00002fc0| 6c 65 64 20 69 6e 20 74 | 68 65 20 63 6f 64 65 3b |led in t|he code;|
|00002fd0| 20 74 68 6f 73 65 20 66 | 6f 72 20 43 61 6e 63 65 | those f|or Cance|
|00002fe0| 6c 20 61 72 65 20 68 61 | 6e 64 6c 65 64 20 62 79 |l are ha|ndled by|
|00002ff0| 20 6d 65 61 6e 73 20 6f | 66 20 74 68 65 20 68 69 | means o|f the hi|
|00003000| 64 64 65 6e 20 73 74 61 | 74 69 63 20 74 65 78 74 |dden sta|tic text|
|00003010| 20 66 69 65 6c 64 2c 20 | 77 68 69 63 68 20 64 65 | field, |which de|
|00003020| 66 69 6e 65 73 20 64 65 | 66 61 75 6c 74 20 43 6f |fines de|fault Co|
|00003030| 6d 6d 61 6e 64 2d 6b 65 | 79 20 65 71 75 69 76 61 |mmand-ke|y equiva|
|00003040| 6c 65 6e 74 73 20 66 6f | 72 20 74 68 65 20 72 65 |lents fo|r the re|
|00003050| 73 74 20 6f 66 20 74 68 | 65 20 63 6f 6e 74 72 6f |st of th|e contro|
|00003060| 6c 73 20 69 6e 20 74 68 | 65 20 64 69 61 6c 6f 67 |ls in th|e dialog|
|00003070| 20 61 73 20 77 65 6c 6c | 2e 20 0d 41 20 44 49 54 | as well|. .A DIT|
|00003080| 4c 20 6e 65 65 64 73 20 | 74 6f 20 62 65 20 63 72 |L needs |to be cr|
|00003090| 65 61 74 65 64 20 66 6f | 72 20 65 61 63 68 20 70 |eated fo|r each p|
|000030a0| 61 6e 65 2e 20 54 68 65 | 20 66 69 72 73 74 20 69 |ane. The| first i|
|000030b0| 74 65 6d 20 69 73 20 61 | 20 68 69 64 64 65 6e 20 |tem is a| hidden |
|000030c0| 73 74 61 74 69 63 20 74 | 65 78 74 20 66 69 65 6c |static t|ext fiel|
|000030d0| 64 20 74 68 61 74 20 64 | 65 66 69 6e 65 73 20 43 |d that d|efines C|
|000030e0| 6f 6d 6d 61 6e 64 2d 6b | 65 79 20 65 71 75 69 76 |ommand-k|ey equiv|
|000030f0| 61 6c 65 6e 74 73 20 66 | 6f 72 20 74 68 65 20 69 |alents f|or the i|
|00003100| 74 65 6d 73 20 69 6e 20 | 74 68 65 20 70 61 6e 65 |tems in |the pane|
|00003110| 3b 20 74 68 69 73 20 69 | 73 20 69 6e 20 61 64 64 |; this i|s in add|
|00003120| 69 74 69 6f 6e 20 74 6f | 20 74 68 65 20 64 65 66 |ition to| the def|
|00003130| 61 75 6c 74 20 6c 69 73 | 74 20 69 6e 20 74 68 65 |ault lis|t in the|
|00003140| 20 6d 61 69 6e 20 44 49 | 54 4c 2e 20 53 65 65 20 | main DI|TL. See |
|00003150| d2 43 6f 64 65 20 66 6f | 72 20 44 69 61 6c 6f 67 |.Code fo|r Dialog|
|00003160| 20 43 6f 6d 6d 61 6e 64 | 2d 4b 65 79 20 45 71 75 | Command|-Key Equ|
|00003170| 69 76 61 6c 65 6e 74 73 | d3 20 66 6f 72 20 64 65 |ivalents|. for de|
|00003180| 74 61 69 6c 73 20 6f 66 | 20 74 68 65 20 73 79 6e |tails of| the syn|
|00003190| 74 61 78 2e 20 0d 54 68 | 65 20 69 74 65 6d 73 20 |tax. .Th|e items |
|000031a0| 61 72 65 20 6e 75 6d 62 | 65 72 65 64 20 6c 6f 63 |are numb|ered loc|
|000031b0| 61 6c 20 74 6f 20 65 61 | 63 68 20 44 49 54 4c 2c |al to ea|ch DITL,|
|000031c0| 20 73 6f 20 74 68 61 74 | 2c 20 66 6f 72 20 65 78 | so that|, for ex|
|000031d0| 61 6d 70 6c 65 2c 20 74 | 68 65 20 66 69 72 73 74 |ample, t|he first|
|000031e0| 20 63 6f 6e 74 72 6f 6c | 20 77 6f 75 6c 64 20 62 | control| would b|
|000031f0| 65 20 69 74 65 6d 20 32 | 2e 20 41 6c 6c 20 75 73 |e item 2|. All us|
|00003200| 65 72 20 69 74 65 6d 73 | 20 69 6e 20 74 68 65 20 |er items| in the |
|00003210| 44 49 54 4c 20 61 72 65 | 20 73 65 74 20 74 6f 20 |DITL are| set to |
|00003220| 74 68 65 20 44 72 61 77 | 47 72 61 79 20 70 72 6f |the Draw|Gray pro|
|00003230| 63 65 64 75 72 65 2c 20 | 77 68 69 63 68 20 6f 75 |cedure, |which ou|
|00003240| 74 6c 69 6e 65 73 20 74 | 68 65 20 69 74 65 6d d5 |tlines t|he item.|
|00003250| 73 20 72 65 63 74 61 6e | 67 6c 65 20 77 69 74 68 |s rectan|gle with|
|00003260| 20 65 69 74 68 65 72 20 | 74 68 65 20 67 72 61 79 | either |the gray|
|00003270| 20 63 6f 6c 6f 72 20 6f | 72 20 61 20 73 74 69 70 | color o|r a stip|
|00003280| 70 6c 65 64 20 67 72 61 | 79 20 70 61 74 74 65 72 |pled gra|y patter|
|00003290| 6e 2c 20 64 65 70 65 6e | 64 69 6e 67 20 6f 6e 20 |n, depen|ding on |
|000032a0| 74 68 65 20 75 73 65 72 | d5 73 20 6d 6f 6e 69 74 |the user|.s monit|
|000032b0| 6f 72 2e 20 0d 4e 65 78 | 74 2c 20 61 20 44 54 4c |or. .Nex|t, a DTL|
|000032c0| 23 20 72 65 73 6f 75 72 | 63 65 20 73 68 6f 75 6c |# resour|ce shoul|
|000032d0| 64 20 62 65 20 63 72 65 | 61 74 65 64 20 77 69 74 |d be cre|ated wit|
|000032e0| 68 20 74 68 65 20 73 61 | 6d 65 20 72 65 73 6f 75 |h the sa|me resou|
|000032f0| 72 63 65 20 49 44 20 61 | 73 20 74 68 65 20 6d 61 |rce ID a|s the ma|
|00003300| 69 6e 20 44 4c 4f 47 20 | 72 65 73 6f 75 72 63 65 |in DLOG |resource|
|00003310| 2e 20 49 74 20 63 6f 6e | 74 61 69 6e 73 20 61 20 |. It con|tains a |
|00003320| 6c 69 73 74 20 6f 66 20 | 74 68 65 20 72 65 73 6f |list of |the reso|
|00003330| 75 72 63 65 20 49 44 73 | 20 6f 66 20 74 68 65 20 |urce IDs| of the |
|00003340| 44 49 54 4c 73 20 74 68 | 61 74 20 63 6f 6d 70 72 |DITLs th|at compr|
|00003350| 69 73 65 20 61 20 73 70 | 65 63 69 66 69 63 20 6d |ise a sp|ecific m|
|00003360| 75 6c 74 69 70 61 6e 65 | 20 64 69 61 6c 6f 67 20 |ultipane| dialog |
|00003370| 61 6e 64 20 74 68 65 20 | 74 65 78 74 20 64 69 73 |and the |text dis|
|00003380| 70 6c 61 79 65 64 20 75 | 6e 64 65 72 20 65 61 63 |played u|nder eac|
|00003390| 68 20 69 63 6f 6e 20 69 | 6e 20 74 68 65 20 6c 69 |h icon i|n the li|
|000033a0| 73 74 2e 20 54 68 65 6e | 20 74 68 65 20 69 63 6f |st. Then| the ico|
|000033b0| 6e 20 67 72 6f 75 70 73 | 20 61 72 65 20 63 72 65 |n groups| are cre|
|000033c0| 61 74 65 64 3b 20 74 68 | 65 79 20 68 61 76 65 20 |ated; th|ey have |
|000033d0| 74 68 65 20 73 61 6d 65 | 20 72 65 73 6f 75 72 63 |the same| resourc|
|000033e0| 65 20 49 44 20 61 73 20 | 74 68 65 20 44 49 54 4c |e ID as |the DITL|
|000033f0| 20 74 6f 20 77 68 69 63 | 68 20 74 68 65 79 20 63 | to whic|h they c|
|00003400| 6f 72 72 65 73 70 6f 6e | 64 2e 20 53 6d 61 6c 6c |orrespon|d. Small|
|00003410| 20 76 65 72 73 69 6f 6e | 73 20 6f 66 20 74 68 65 | version|s of the|
|00003420| 20 69 63 6f 6e 73 20 61 | 72 65 6e d5 74 20 6e 65 | icons a|ren.t ne|
|00003430| 65 64 65 64 2c 20 62 75 | 74 20 63 6f 6c 6f 72 20 |eded, bu|t color |
|00003440| 76 65 72 73 69 6f 6e 73 | 20 73 68 6f 75 6c 64 20 |versions| should |
|00003450| 62 65 20 63 72 65 61 74 | 65 64 20 66 6f 72 20 64 |be creat|ed for d|
|00003460| 69 73 70 6c 61 79 20 6f | 6e 20 63 6f 6c 6f 72 2d |isplay o|n color-|
|00003470| 63 61 70 61 62 6c 65 20 | 4d 61 63 69 6e 74 6f 73 |capable |Macintos|
|00003480| 68 20 63 6f 6d 70 75 74 | 65 72 73 2e 0d 4f 70 74 |h comput|ers..Opt|
|00003490| 69 6f 6e 61 6c 20 44 47 | 52 50 20 72 65 73 6f 75 |ional DG|RP resou|
|000034a0| 72 63 65 73 20 63 61 6e | 20 62 65 20 63 72 65 61 |rces can| be crea|
|000034b0| 74 65 64 20 66 6f 72 20 | 73 70 65 63 69 66 79 69 |ted for |specifyi|
|000034c0| 6e 67 20 72 61 64 69 6f | 20 62 75 74 74 6f 6e 20 |ng radio| button |
|000034d0| 67 72 6f 75 70 73 2e 20 | 54 68 65 20 72 65 73 6f |groups. |The reso|
|000034e0| 75 72 63 65 20 49 44 20 | 69 73 20 74 68 65 20 73 |urce ID |is the s|
|000034f0| 61 6d 65 20 61 73 20 74 | 68 61 74 20 6f 66 20 74 |ame as t|hat of t|
|00003500| 68 65 20 63 6f 72 72 65 | 73 70 6f 6e 64 69 6e 67 |he corre|sponding|
|00003510| 20 70 61 6e 65 d5 73 20 | 44 49 54 4c 2e 20 45 61 | pane.s |DITL. Ea|
|00003520| 63 68 20 44 47 52 50 20 | 63 61 6e 20 63 6f 6e 74 |ch DGRP |can cont|
|00003530| 61 69 6e 20 6d 75 6c 74 | 69 70 6c 65 20 67 72 6f |ain mult|iple gro|
|00003540| 75 70 73 20 70 65 72 20 | 70 61 6e 65 2c 20 69 66 |ups per |pane, if|
|00003550| 20 64 65 73 69 72 65 64 | 3b 20 68 6f 77 65 76 65 | desired|; howeve|
|00003560| 72 2c 20 61 20 70 61 72 | 74 69 63 75 6c 61 72 20 |r, a par|ticular |
|00003570| 72 61 64 69 6f 20 62 75 | 74 74 6f 6e 20 73 68 6f |radio bu|tton sho|
|00003580| 75 6c 64 20 6f 6e 6c 79 | 20 62 65 20 75 73 65 64 |uld only| be used|
|00003590| 20 69 6e 20 61 20 73 69 | 6e 67 6c 65 20 67 72 6f | in a si|ngle gro|
|000035a0| 75 70 2e 20 4c 69 6b 65 | 20 74 68 65 20 70 65 72 |up. Like| the per|
|000035b0| 2d 70 61 6e 65 20 43 6f | 6d 6d 61 6e 64 2d 6b 65 |-pane Co|mmand-ke|
|000035c0| 79 20 65 71 75 69 76 61 | 6c 65 6e 74 20 73 74 72 |y equiva|lent str|
|000035d0| 69 6e 67 73 2c 20 69 74 | 65 6d 73 20 61 72 65 20 |ings, it|ems are |
|000035e0| 6e 75 6d 62 65 72 65 64 | 20 6c 6f 63 61 6c 20 74 |numbered| local t|
|000035f0| 6f 20 74 68 65 20 44 49 | 54 4c 2e 0d 59 6f 75 20 |o the DI|TL..You |
|00003600| 73 68 6f 75 6c 64 20 61 | 6c 73 6f 20 63 6f 70 79 |should a|lso copy|
|00003610| 20 74 68 65 20 66 6f 6c | 6c 6f 77 69 6e 67 3a 0d | the fol|lowing:.|
|00003620| a5 09 74 68 65 20 70 73 | 65 75 64 6f 2d 43 44 45 |..the ps|eudo-CDE|
|00003630| 46 20 77 69 74 68 20 72 | 65 73 6f 75 72 63 65 20 |F with r|esource |
|00003640| 49 44 20 32 35 31 2c 20 | 77 68 69 63 68 20 70 72 |ID 251, |which pr|
|00003650| 6f 76 69 64 65 73 20 73 | 75 70 70 6f 72 74 20 66 |ovides s|upport f|
|00003660| 6f 72 20 75 73 69 6e 67 | 20 74 68 65 20 69 63 6f |or using| the ico|
|00003670| 6e 20 6c 69 73 74 20 61 | 73 20 61 20 63 6f 6e 74 |n list a|s a cont|
|00003680| 72 6f 6c 20 28 69 6e 20 | 74 68 65 20 66 69 6c 65 |rol (in |the file|
|00003690| 20 4d 50 44 69 61 6c 6f | 67 73 20 52 65 73 6f 75 | MPDialo|gs Resou|
|000036a0| 72 63 65 73 29 0d a5 09 | 74 68 65 20 4c 44 45 46 |rces)...|the LDEF|
|000036b0| 20 77 69 74 68 20 72 65 | 73 6f 75 72 63 65 20 49 | with re|source I|
|000036c0| 44 20 31 33 30 2c 20 77 | 68 69 63 68 20 69 6d 70 |D 130, w|hich imp|
|000036d0| 6c 65 6d 65 6e 74 73 20 | 74 68 65 20 69 63 6f 6e |lements |the icon|
|000036e0| 20 6c 69 73 74 20 64 65 | 66 69 6e 69 74 69 6f 6e | list de|finition|
|000036f0| 20 66 6f 72 20 74 68 65 | 20 4c 69 73 74 20 4d 61 | for the| List Ma|
|00003700| 6e 61 67 65 72 20 28 69 | 6e 20 74 68 65 20 66 69 |nager (i|n the fi|
|00003710| 6c 65 20 49 63 6f 6e 20 | 4c 44 45 46 20 69 6e 20 |le Icon |LDEF in |
|00003720| 74 68 65 20 4c 44 45 46 | 20 66 6f 6c 64 65 72 29 |the LDEF| folder)|
|00003730| 0d a5 09 6f 70 74 69 6f | 6e 61 6c 6c 79 2c 20 74 |...optio|nally, t|
|00003740| 68 65 20 27 68 64 6c 67 | 27 20 72 65 73 6f 75 72 |he 'hdlg|' resour|
|00003750| 63 65 20 61 6e 64 20 63 | 6f 72 72 65 73 70 6f 6e |ce and c|orrespon|
|00003760| 64 69 6e 67 20 53 54 52 | 23 20 72 65 73 6f 75 72 |ding STR|# resour|
|00003770| 63 65 20 66 6f 72 20 42 | 61 6c 6c 6f 6f 6e 20 48 |ce for B|alloon H|
|00003780| 65 6c 70 20 73 75 70 70 | 6f 72 74 20 28 69 6e 20 |elp supp|ort (in |
|00003790| 74 68 65 20 66 69 6c 65 | 20 4d 50 44 69 61 6c 6f |the file| MPDialo|
|000037a0| 67 73 20 52 65 73 6f 75 | 72 63 65 73 29 0d 59 6f |gs Resou|rces).Yo|
|000037b0| 75 20 63 61 6e 20 61 64 | 64 20 42 61 6c 6c 6f 6f |u can ad|d Balloo|
|000037c0| 6e 20 48 65 6c 70 20 74 | 6f 20 61 20 6d 75 6c 74 |n Help t|o a mult|
|000037d0| 69 70 61 6e 65 20 64 69 | 61 6c 6f 67 20 62 79 20 |ipane di|alog by |
|000037e0| 61 64 64 69 6e 67 20 74 | 77 6f 20 68 65 6c 70 20 |adding t|wo help |
|000037f0| 69 74 65 6d 73 20 74 6f | 20 74 68 65 20 69 6e 64 |items to| the ind|
|00003800| 69 76 69 64 75 61 6c 20 | 44 49 54 4c 20 72 65 73 |ividual |DITL res|
|00003810| 6f 75 72 63 65 73 20 74 | 68 61 74 20 6d 61 6b 65 |ources t|hat make|
|00003820| 20 75 70 20 65 61 63 68 | 20 70 61 6e 65 2e 20 4f | up each| pane. O|
|00003830| 6e 65 20 69 73 20 66 6f | 72 20 74 68 65 20 63 6f |ne is fo|r the co|
|00003840| 6e 74 72 6f 6c 73 20 69 | 6e 20 74 68 65 20 6d 61 |ntrols i|n the ma|
|00003850| 69 6e 20 44 49 54 4c 20 | 61 6e 64 20 75 73 65 73 |in DITL |and uses|
|00003860| 20 61 6e 20 27 68 64 6c | 67 27 20 72 65 73 6f 75 | an 'hdl|g' resou|
|00003870| 72 63 65 20 61 6e 64 20 | 61 6e 20 53 54 52 23 20 |rce and |an STR# |
|00003880| 72 65 73 6f 75 72 63 65 | 20 77 69 74 68 20 74 68 |resource| with th|
|00003890| 65 20 73 61 6d 65 20 49 | 44 2e 20 54 68 65 20 73 |e same I|D. The s|
|000038a0| 65 63 6f 6e 64 20 68 65 | 6c 70 20 69 74 65 6d 20 |econd he|lp item |
|000038b0| 69 73 20 61 6e 20 27 68 | 64 6c 67 27 20 72 65 73 |is an 'h|dlg' res|
|000038c0| 6f 75 72 63 65 20 66 6f | 72 20 65 61 63 68 20 70 |ource fo|r each p|
|000038d0| 61 6e 65 d5 73 20 44 49 | 54 4c 3b 20 69 74 20 73 |ane.s DI|TL; it s|
|000038e0| 68 6f 75 6c 64 20 73 74 | 61 72 74 20 61 74 20 69 |hould st|art at i|
|000038f0| 74 65 6d 20 38 20 66 6f | 72 20 74 68 65 20 66 69 |tem 8 fo|r the fi|
|00003900| 72 73 74 20 63 6f 6e 74 | 72 6f 6c 20 69 6e 20 74 |rst cont|rol in t|
|00003910| 68 65 20 70 61 6e 65 2e | 20 53 65 65 20 74 68 65 |he pane.| See the|
|00003920| 20 66 69 6c 65 20 4d 50 | 44 69 61 6c 6f 67 73 2e | file MP|Dialogs.|
|00003930| b5 2e 72 73 72 63 20 6f | 6e 20 74 68 65 20 43 44 |..rsrc o|n the CD|
|00003940| 20 66 6f 72 20 61 20 73 | 61 6d 70 6c 65 20 27 68 | for a s|ample 'h|
|00003950| 64 6c 67 27 20 72 65 73 | 6f 75 72 63 65 20 66 6f |dlg' res|ource fo|
|00003960| 72 20 74 68 65 20 66 69 | 72 73 74 20 70 61 6e 65 |r the fi|rst pane|
|00003970| 2e 0d 43 41 4c 4c 49 4e | 47 20 54 48 45 20 4d 41 |..CALLIN|G THE MA|
|00003980| 49 4e 20 52 4f 55 54 49 | 4e 45 53 0d 4e 6f 77 20 |IN ROUTI|NES.Now |
|00003990| 6c 65 74 d5 73 20 6c 6f | 6f 6b 20 61 74 20 74 68 |let.s lo|ok at th|
|000039a0| 65 20 63 61 6c 6c 73 20 | 79 6f 75 72 20 61 70 70 |e calls |your app|
|000039b0| 6c 69 63 61 74 69 6f 6e | 20 6e 65 65 64 73 20 74 |lication| needs t|
|000039c0| 6f 20 6d 61 6b 65 20 74 | 6f 20 74 68 65 20 6d 61 |o make t|o the ma|
|000039d0| 69 6e 20 72 6f 75 74 69 | 6e 65 73 20 69 6e 20 6f |in routi|nes in o|
|000039e0| 72 64 65 72 20 74 6f 20 | 6f 70 65 6e 20 74 68 65 |rder to |open the|
|000039f0| 20 6d 75 6c 74 69 70 61 | 6e 65 20 64 69 61 6c 6f | multipa|ne dialo|
|00003a00| 67 20 61 6e 64 20 68 61 | 6e 64 6c 65 20 65 76 65 |g and ha|ndle eve|
|00003a10| 6e 74 73 2c 20 61 73 20 | 77 65 6c 6c 20 61 73 20 |nts, as |well as |
|00003a20| 74 6f 20 61 63 63 65 73 | 73 20 74 68 65 20 76 61 |to acces|s the va|
|00003a30| 6c 75 65 73 20 6f 66 20 | 74 68 65 20 63 6f 6e 74 |lues of |the cont|
|00003a40| 72 6f 6c 73 20 69 6e 20 | 61 20 64 69 61 6c 6f 67 |rols in |a dialog|
|00003a50| 2e 20 42 75 74 20 66 69 | 72 73 74 2c 20 6c 65 74 |. But fi|rst, let|
|00003a60| d5 73 20 6c 6f 6f 6b 20 | 61 74 20 74 68 65 20 64 |.s look |at the d|
|00003a70| 61 74 61 20 79 6f 75 72 | 20 61 70 70 6c 69 63 61 |ata your| applica|
|00003a80| 74 69 6f 6e 20 6e 65 65 | 64 73 20 74 6f 20 6d 61 |tion nee|ds to ma|
|00003a90| 69 6e 74 61 69 6e 2e 0d | 50 4f 49 4e 54 45 52 53 |intain..|POINTERS|
|00003aa0| 20 41 4e 44 20 48 41 4e | 44 4c 45 53 0d 59 6f 75 | AND HAN|DLES.You|
|00003ab0| 72 20 61 70 70 6c 69 63 | 61 74 69 6f 6e 20 6d 75 |r applic|ation mu|
|00003ac0| 73 74 20 6d 61 69 6e 74 | 61 69 6e 20 61 20 44 69 |st maint|ain a Di|
|00003ad0| 61 6c 6f 67 50 74 72 20 | 66 6f 72 20 65 61 63 68 |alogPtr |for each|
|00003ae0| 20 64 69 61 6c 6f 67 20 | 75 73 65 64 2e 20 59 6f | dialog |used. Yo|
|00003af0| 75 20 61 6c 73 6f 20 6e | 65 65 64 20 74 6f 20 64 |u also n|eed to d|
|00003b00| 65 63 6c 61 72 65 20 61 | 20 68 61 6e 64 6c 65 20 |eclare a| handle |
|00003b10| 66 6f 72 20 73 74 6f 72 | 69 6e 67 20 74 68 65 20 |for stor|ing the |
|00003b20| 72 65 74 75 72 6e 65 64 | 20 73 65 74 74 69 6e 67 |returned| setting|
|00003b30| 73 2e 20 50 61 73 73 69 | 6e 67 20 61 20 70 6f 69 |s. Passi|ng a poi|
|00003b40| 6e 74 65 72 20 74 6f 20 | 4e 55 4c 4c 20 63 61 75 |nter to |NULL cau|
|00003b50| 73 65 73 20 74 68 65 20 | 63 6f 64 65 20 74 6f 20 |ses the |code to |
|00003b60| 61 6c 6c 6f 63 61 74 65 | 20 61 20 6e 65 77 20 68 |allocate| a new h|
|00003b70| 61 6e 64 6c 65 20 61 6e | 64 20 72 65 74 75 72 6e |andle an|d return|
|00003b80| 20 69 74 20 74 6f 20 74 | 68 65 20 63 61 6c 6c 65 | it to t|he calle|
|00003b90| 72 3b 20 6f 74 68 65 72 | 77 69 73 65 2c 20 61 20 |r; other|wise, a |
|00003ba0| 68 61 6e 64 6c 65 20 74 | 6f 20 61 6e 20 65 78 69 |handle t|o an exi|
|00003bb0| 73 74 69 6e 67 20 72 65 | 63 6f 72 64 20 6d 75 73 |sting re|cord mus|
|00003bc0| 74 20 62 65 20 70 72 6f | 76 69 64 65 64 2e 20 46 |t be pro|vided. F|
|00003bd0| 6f 72 20 61 20 70 72 65 | 66 65 72 65 6e 63 65 73 |or a pre|ferences|
|00003be0| 20 64 69 61 6c 6f 67 2c | 20 74 68 69 73 20 64 61 | dialog,| this da|
|00003bf0| 74 61 20 73 68 6f 75 6c | 64 20 62 65 20 6d 61 69 |ta shoul|d be mai|
|00003c00| 6e 74 61 69 6e 65 64 20 | 69 6e 20 74 68 65 20 61 |ntained |in the a|
|00003c10| 70 70 6c 69 63 61 74 69 | 6f 6e d5 73 20 70 72 65 |pplicati|on.s pre|
|00003c20| 66 65 72 65 6e 63 65 73 | 20 66 69 6c 65 20 69 6e |ferences| file in|
|00003c30| 20 74 68 65 20 50 72 65 | 66 65 72 65 6e 63 65 73 | the Pre|ferences|
|00003c40| 20 66 6f 6c 64 65 72 2e | 20 0d 49 6d 70 6c 65 6d | folder.| .Implem|
|00003c50| 65 6e 74 69 6e 67 20 70 | 72 65 66 65 72 65 6e 63 |enting p|referenc|
|00003c60| 65 73 20 66 69 6c 65 73 | 20 69 73 20 64 69 73 63 |es files| is disc|
|00003c70| 75 73 73 65 64 20 69 6e | 20 74 68 65 20 61 72 74 |ussed in| the art|
|00003c80| 69 63 6c 65 20 d2 54 68 | 65 20 52 69 67 68 74 20 |icle .Th|e Right |
|00003c90| 57 61 79 20 74 6f 20 49 | 6d 70 6c 65 6d 65 6e 74 |Way to I|mplement|
|00003ca0| 20 50 72 65 66 65 72 65 | 6e 63 65 73 20 46 69 6c | Prefere|nces Fil|
|00003cb0| 65 73 d3 20 69 6e 20 64 | 65 76 65 6c 6f 70 20 49 |es. in d|evelop I|
|00003cc0| 73 73 75 65 20 31 38 2e | a5 0d 54 68 65 20 73 61 |ssue 18.|..The sa|
|00003cd0| 6d 70 6c 65 20 63 6f 64 | 65 20 69 6e 74 65 72 6e |mple cod|e intern|
|00003ce0| 61 6c 6c 79 20 61 6c 6c | 6f 63 61 74 65 73 20 61 |ally all|ocates a|
|00003cf0| 6e 20 4d 50 44 48 64 6c | 20 66 6f 72 20 65 61 63 |n MPDHdl| for eac|
|00003d00| 68 20 6f 70 65 6e 20 6d | 75 6c 74 69 70 61 6e 65 |h open m|ultipane|
|00003d10| 20 64 69 61 6c 6f 67 20 | 66 6f 72 20 73 74 6f 72 | dialog |for stor|
|00003d20| 69 6e 67 20 73 74 61 74 | 65 20 69 6e 66 6f 72 6d |ing stat|e inform|
|00003d30| 61 74 69 6f 6e 2e 20 54 | 68 65 20 68 61 6e 64 6c |ation. T|he handl|
|00003d40| 65 20 69 73 20 73 74 6f | 72 65 64 20 69 6e 20 74 |e is sto|red in t|
|00003d50| 68 65 20 72 65 66 43 6f | 6e 20 6f 66 20 74 68 65 |he refCo|n of the|
|00003d60| 20 64 69 61 6c 6f 67 2e | 0d 4f 50 45 4e 49 4e 47 | dialog.|.OPENING|
|00003d70| 2c 20 48 41 4e 44 4c 49 | 4e 47 20 45 56 45 4e 54 |, HANDLI|NG EVENT|
|00003d80| 53 2c 20 41 4e 44 20 43 | 4c 4f 53 49 4e 47 0d 59 |S, AND C|LOSING.Y|
|00003d90| 6f 75 72 20 61 70 70 6c | 69 63 61 74 69 6f 6e 20 |our appl|ication |
|00003da0| 73 68 6f 75 6c 64 20 63 | 61 6c 6c 20 4f 70 65 6e |should c|all Open|
|00003db0| 4d 50 44 69 61 6c 6f 67 | 20 66 6f 72 20 65 61 63 |MPDialog| for eac|
|00003dc0| 68 20 64 65 73 69 72 65 | 64 20 6d 75 6c 74 69 70 |h desire|d multip|
|00003dd0| 61 6e 65 20 64 69 61 6c | 6f 67 2c 20 74 61 6b 69 |ane dial|og, taki|
|00003de0| 6e 67 20 61 6e 79 20 61 | 63 74 69 6f 6e 73 20 6e |ng any a|ctions n|
|00003df0| 65 63 65 73 73 61 72 79 | 20 77 68 65 6e 20 61 20 |ecessary| when a |
|00003e00| 64 69 61 6c 6f 67 20 69 | 73 20 6f 70 65 6e 65 64 |dialog i|s opened|
|00003e10| 2c 20 73 75 63 68 20 61 | 73 20 64 69 73 61 62 6c |, such a|s disabl|
|00003e20| 69 6e 67 20 6d 65 6e 75 | 73 2e 20 54 68 69 73 20 |ing menu|s. This |
|00003e30| 63 61 6c 6c 20 69 73 20 | 70 61 73 73 65 64 20 74 |call is |passed t|
|00003e40| 68 65 20 72 65 73 6f 75 | 72 63 65 20 49 44 20 6f |he resou|rce ID o|
|00003e50| 66 20 74 68 65 20 44 4c | 4f 47 20 66 6f 72 20 74 |f the DL|OG for t|
|00003e60| 68 65 20 64 69 61 6c 6f | 67 2c 20 61 20 72 65 66 |he dialo|g, a ref|
|00003e70| 65 72 65 6e 63 65 20 74 | 6f 20 74 68 65 20 68 61 |erence t|o the ha|
|00003e80| 6e 64 6c 65 20 74 68 61 | 74 20 73 74 6f 72 65 73 |ndle tha|t stores|
|00003e90| 20 74 68 65 20 72 65 74 | 75 72 6e 65 64 20 73 65 | the ret|urned se|
|00003ea0| 74 74 69 6e 67 73 2c 20 | 61 6e 64 20 66 6f 75 72 |ttings, |and four|
|00003eb0| 20 6f 70 74 69 6f 6e 61 | 6c 20 70 61 72 61 6d 65 | optiona|l parame|
|00003ec0| 74 65 72 73 2c 20 77 68 | 69 63 68 20 61 72 65 20 |ters, wh|ich are |
|00003ed0| 64 65 73 63 72 69 62 65 | 64 20 6c 61 74 65 72 2e |describe|d later.|
|00003ee0| 0d 48 65 72 65 d5 73 20 | 61 6e 20 65 78 61 6d 70 |.Here.s |an examp|
|00003ef0| 6c 65 3a 0d 44 69 61 6c | 6f 67 50 74 72 20 70 72 |le:.Dial|ogPtr pr|
|00003f00| 65 66 44 6c 6f 67 20 3d | 20 4e 55 4c 4c 3b 0d 48 |efDlog =| NULL;.H|
|00003f10| 61 6e 64 6c 65 20 74 68 | 65 50 72 65 66 73 20 3d |andle th|ePrefs =|
|00003f20| 20 4e 55 4c 4c 3b 0d 70 | 72 65 66 44 6c 6f 67 20 | NULL;.p|refDlog |
|00003f30| 3d 20 4f 70 65 6e 4d 50 | 44 69 61 6c 6f 67 28 6b |= OpenMP|Dialog(k|
|00003f40| 50 72 65 66 44 4c 4f 47 | 2c 20 4e 55 4c 4c 2c 20 |PrefDLOG|, NULL, |
|00003f50| 4e 55 4c 4c 2c 20 4e 55 | 4c 4c 2c 20 4e 55 4c 4c |NULL, NU|LL, NULL|
|00003f60| 2c 20 26 74 68 65 50 72 | 65 66 73 29 3b 0d 69 66 |, &thePr|efs);.if|
|00003f70| 20 28 70 72 65 66 44 6c | 6f 67 29 20 53 65 74 4d | (prefDl|og) SetM|
|00003f80| 65 6e 75 73 42 75 73 79 | 28 29 3b 20 20 2f 2f 20 |enusBusy|(); // |
|00003f90| 49 66 20 4e 55 4c 4c 2c | 20 74 68 65 20 64 69 61 |If NULL,| the dia|
|00003fa0| 6c 6f 67 20 63 6f 75 6c | 64 6e 27 74 20 62 65 20 |log coul|dn't be |
|00003fb0| 6f 70 65 6e 65 64 2e 20 | 0d 54 68 65 20 6d 61 69 |opened. |.The mai|
|00003fc0| 6e 20 65 76 65 6e 74 20 | 6c 6f 6f 70 20 73 68 6f |n event |loop sho|
|00003fd0| 75 6c 64 20 63 61 6c 6c | 20 44 6f 4d 50 44 69 61 |uld call| DoMPDia|
|00003fe0| 6c 6f 67 45 76 65 6e 74 | 20 61 66 74 65 72 20 65 |logEvent| after e|
|00003ff0| 61 63 68 20 65 76 65 6e | 74 20 69 73 20 72 65 74 |ach even|t is ret|
|00004000| 75 72 6e 65 64 20 66 72 | 6f 6d 20 57 61 69 74 4e |urned fr|om WaitN|
|00004010| 65 78 74 45 76 65 6e 74 | 2e 20 49 66 20 44 6f 4d |extEvent|. If DoM|
|00004020| 50 44 69 61 6c 6f 67 45 | 76 65 6e 74 20 72 65 74 |PDialogE|vent ret|
|00004030| 75 72 6e 73 20 74 72 75 | 65 2c 20 74 68 65 20 6d |urns tru|e, the m|
|00004040| 75 6c 74 69 70 61 6e 65 | 20 64 69 61 6c 6f 67 20 |ultipane| dialog |
|00004050| 72 6f 75 74 69 6e 65 73 | 20 68 61 76 65 20 68 61 |routines| have ha|
|00004060| 6e 64 6c 65 64 20 74 68 | 65 20 65 76 65 6e 74 3b |ndled th|e event;|
|00004070| 20 79 6f 75 72 20 61 70 | 70 6c 69 63 61 74 69 6f | your ap|plicatio|
|00004080| 6e 20 73 68 6f 75 6c 64 | 20 69 6e 73 70 65 63 74 |n should| inspect|
|00004090| 20 74 68 65 20 44 69 61 | 6c 6f 67 50 74 72 20 74 | the Dia|logPtr t|
|000040a0| 6f 20 0d 64 65 74 65 72 | 6d 69 6e 65 20 77 68 65 |o .deter|mine whe|
|000040b0| 74 68 65 72 20 74 68 65 | 20 64 69 61 6c 6f 67 20 |ther the| dialog |
|000040c0| 68 61 73 20 62 65 65 6e | 20 63 6c 6f 73 65 64 2c |has been| closed,|
|000040d0| 20 73 6f 20 74 68 61 74 | 20 74 68 65 20 61 70 70 | so that| the app|
|000040e0| 6c 69 63 61 74 69 6f 6e | 20 63 61 6e 20 72 65 63 |lication| can rec|
|000040f0| 6f 76 65 72 20 66 72 6f | 6d 20 74 68 65 20 64 69 |over fro|m the di|
|00004100| 61 6c 6f 67 20 73 74 61 | 74 65 2e 20 41 20 72 65 |alog sta|te. A re|
|00004110| 74 75 72 6e 20 76 61 6c | 75 65 20 6f 66 20 66 61 |turn val|ue of fa|
|00004120| 6c 73 65 20 69 6e 64 69 | 63 61 74 65 73 20 74 68 |lse indi|cates th|
|00004130| 61 74 20 79 6f 75 72 20 | 61 70 70 6c 69 63 61 74 |at your |applicat|
|00004140| 69 6f 6e 20 73 68 6f 75 | 6c 64 20 70 72 6f 63 65 |ion shou|ld proce|
|00004150| 73 73 20 74 68 65 20 65 | 76 65 6e 74 20 61 73 20 |ss the e|vent as |
|00004160| 69 74 20 77 6f 75 6c 64 | 20 6e 6f 72 6d 61 6c 6c |it would| normall|
|00004170| 79 2e 20 46 6f 72 20 65 | 78 61 6d 70 6c 65 3a 0d |y. For e|xample:.|
|00004180| 69 66 20 28 44 6f 4d 50 | 44 69 61 6c 6f 67 45 76 |if (DoMP|DialogEv|
|00004190| 65 6e 74 28 26 70 72 65 | 66 44 6c 6f 67 2c 20 26 |ent(&pre|fDlog, &|
|000041a0| 6d 61 69 6e 45 76 65 6e | 74 52 65 63 29 29 20 7b |mainEven|tRec)) {|
|000041b0| 0d 09 2f 2f 20 41 20 4e | 55 4c 4c 20 44 69 61 6c |..// A N|ULL Dial|
|000041c0| 6f 67 50 74 72 20 6d 65 | 61 6e 73 20 74 68 65 20 |ogPtr me|ans the |
|000041d0| 64 69 61 6c 6f 67 20 68 | 61 73 20 62 65 65 6e 20 |dialog h|as been |
|000041e0| 63 6c 6f 73 65 64 2e 20 | 0d 09 69 66 20 28 21 70 |closed. |..if (!p|
|000041f0| 72 65 66 44 6c 6f 67 29 | 0d 09 09 53 65 74 4d 65 |refDlog)|...SetMe|
|00004200| 6e 75 73 49 64 6c 65 28 | 29 3b 0d 7d 20 65 6c 73 |nusIdle(|);.} els|
|00004210| 65 20 7b 0d 09 2f 2f 20 | 50 72 6f 63 65 73 73 20 |e {..// |Process |
|00004220| 74 68 65 20 65 76 65 6e | 74 20 61 73 20 75 73 75 |the even|t as usu|
|00004230| 61 6c 2e 20 0d 09 2e 2e | 2e 0d 7d 0d 54 6f 20 64 |al. ....|..}.To d|
|00004240| 69 73 70 6f 73 65 20 6f | 66 20 74 68 65 20 64 69 |ispose o|f the di|
|00004250| 61 6c 6f 67 20 77 69 74 | 68 6f 75 74 20 75 73 65 |alog wit|hout use|
|00004260| 72 20 69 6e 74 65 72 61 | 63 74 69 6f 6e 2c 20 79 |r intera|ction, y|
|00004270| 6f 75 72 20 61 70 70 6c | 69 63 61 74 69 6f 6e 20 |our appl|ication |
|00004280| 63 61 6e 20 63 61 6c 6c | 20 43 6c 6f 73 65 4d 50 |can call| CloseMP|
|00004290| 44 69 61 6c 6f 67 3a 0d | 43 6c 6f 73 65 4d 50 44 |Dialog:.|CloseMPD|
|000042a0| 69 61 6c 6f 67 28 70 72 | 65 66 44 6c 6f 67 29 3b |ialog(pr|efDlog);|
|000042b0| 0d 41 66 74 65 72 20 74 | 68 65 20 64 69 61 6c 6f |.After t|he dialo|
|000042c0| 67 20 68 61 73 20 62 65 | 65 6e 20 63 6c 6f 73 65 |g has be|en close|
|000042d0| 64 2c 20 69 74 d5 73 20 | 74 68 65 20 61 70 70 6c |d, it.s |the appl|
|000042e0| 69 63 61 74 69 6f 6e d5 | 73 20 72 65 73 70 6f 6e |ication.|s respon|
|000042f0| 73 69 62 69 6c 69 74 79 | 20 74 6f 20 64 69 73 70 |sibility| to disp|
|00004300| 6f 73 65 20 6f 66 20 6f | 72 20 73 61 76 65 20 74 |ose of o|r save t|
|00004310| 68 65 20 64 61 74 61 20 | 68 61 6e 64 6c 65 20 63 |he data |handle c|
|00004320| 72 65 61 74 65 64 20 77 | 69 74 68 20 74 68 65 20 |reated w|ith the |
|00004330| 63 61 6c 6c 20 74 6f 20 | 4f 70 65 6e 4d 50 44 69 |call to |OpenMPDi|
|00004340| 61 6c 6f 67 2e 20 54 68 | 65 20 63 6f 64 65 20 49 |alog. Th|e code I|
|00004350| d5 76 65 20 70 72 6f 76 | 69 64 65 64 20 61 73 73 |.ve prov|ided ass|
|00004360| 75 6d 65 73 20 74 68 69 | 73 20 68 61 6e 64 6c 65 |umes thi|s handle|
|00004370| 20 69 73 20 6d 61 69 6e | 74 61 69 6e 65 64 20 62 | is main|tained b|
|00004380| 79 20 74 68 65 20 61 70 | 70 6c 69 63 61 74 69 6f |y the ap|plicatio|
|00004390| 6e 20 61 66 74 65 72 20 | 63 72 65 61 74 69 6f 6e |n after |creation|
|000043a0| 2e 0d 41 43 43 45 53 53 | 49 4e 47 20 43 4f 4e 54 |..ACCESS|ING CONT|
|000043b0| 52 4f 4c 20 56 41 4c 55 | 45 53 0d 54 77 6f 20 72 |ROL VALU|ES.Two r|
|000043c0| 6f 75 74 69 6e 65 73 20 | 61 72 65 20 70 72 6f 76 |outines |are prov|
|000043d0| 69 64 65 64 20 66 6f 72 | 20 61 63 63 65 73 73 69 |ided for| accessi|
|000043e0| 6e 67 20 74 68 65 20 63 | 6f 6e 74 72 6f 6c 20 76 |ng the c|ontrol v|
|000043f0| 61 6c 75 65 73 20 73 74 | 6f 72 65 64 20 69 6e 20 |alues st|ored in |
|00004400| 74 68 65 20 64 61 74 61 | 20 68 61 6e 64 6c 65 3a |the data| handle:|
|00004410| 20 0d a5 09 47 65 74 4d | 50 44 49 74 65 6d 20 72 | ...GetM|PDItem r|
|00004420| 65 74 72 69 65 76 65 73 | 20 74 68 65 20 76 61 6c |etrieves| the val|
|00004430| 75 65 20 6f 66 20 74 68 | 65 20 63 6f 6e 74 72 6f |ue of th|e contro|
|00004440| 6c 20 63 6f 72 72 65 73 | 70 6f 6e 64 69 6e 67 20 |l corres|ponding |
|00004450| 74 6f 20 74 68 65 20 70 | 61 6e 65 20 61 6e 64 20 |to the p|ane and |
|00004460| 69 74 65 6d 20 73 70 65 | 63 69 66 69 65 64 20 61 |item spe|cified a|
|00004470| 6e 64 20 73 74 6f 72 65 | 73 20 69 74 20 69 6e 20 |nd store|s it in |
|00004480| 61 20 62 75 66 66 65 72 | 2e 20 0d a5 09 53 65 74 |a buffer|. ...Set|
|00004490| 4d 50 44 49 74 65 6d 20 | 73 74 6f 72 65 73 20 69 |MPDItem |stores i|
|000044a0| 6e 20 74 68 65 20 68 61 | 6e 64 6c 65 20 61 20 76 |n the ha|ndle a v|
|000044b0| 61 6c 75 65 20 72 65 74 | 72 69 65 76 65 64 20 66 |alue ret|rieved f|
|000044c0| 72 6f 6d 20 61 20 62 75 | 66 66 65 72 2e 20 0d 42 |rom a bu|ffer. .B|
|000044d0| 6f 74 68 20 6f 66 20 74 | 68 65 73 65 20 72 6f 75 |oth of t|hese rou|
|000044e0| 74 69 6e 65 73 20 61 73 | 73 75 6d 65 20 74 68 61 |tines as|sume tha|
|000044f0| 74 20 74 68 65 20 63 61 | 6c 6c 65 72 20 6b 6e 6f |t the ca|ller kno|
|00004500| 77 73 20 74 68 65 20 6c | 65 6e 67 74 68 20 61 6e |ws the l|ength an|
|00004510| 64 20 74 79 70 65 20 6f | 66 20 74 68 65 20 63 6f |d type o|f the co|
|00004520| 6e 74 72 6f 6c d5 73 20 | 64 61 74 61 20 72 65 70 |ntrol.s |data rep|
|00004530| 72 65 73 65 6e 74 61 74 | 69 6f 6e 2e 20 49 74 65 |resentat|ion. Ite|
|00004540| 6d 73 20 61 72 65 20 6e | 75 6d 62 65 72 65 64 20 |ms are n|umbered |
|00004550| 64 69 66 66 65 72 65 6e | 74 6c 79 20 66 72 6f 6d |differen|tly from|
|00004560| 20 69 6e 20 74 68 65 20 | 44 49 54 4c 20 72 65 73 | in the |DITL res|
|00004570| 6f 75 72 63 65 20 d1 20 | 6f 6e 6c 79 20 69 74 65 |ource . |only ite|
|00004580| 6d 73 20 74 68 61 74 20 | 68 61 76 65 20 61 20 76 |ms that |have a v|
|00004590| 61 6c 75 65 20 61 72 65 | 20 69 6e 63 6c 75 64 65 |alue are| include|
|000045a0| 64 2c 20 61 6e 64 20 74 | 68 65 20 76 61 6c 75 65 |d, and t|he value|
|000045b0| 73 20 66 6f 72 20 72 61 | 64 69 6f 20 62 75 74 74 |s for ra|dio butt|
|000045c0| 6f 6e 20 67 72 6f 75 70 | 73 20 63 6f 6d 65 20 61 |on group|s come a|
|000045d0| 66 74 65 72 20 74 68 6f | 73 65 20 66 6f 72 20 61 |fter tho|se for a|
|000045e0| 6c 6c 20 6f 74 68 65 72 | 20 63 6f 6e 74 72 6f 6c |ll other| control|
|000045f0| 73 20 69 6e 20 74 68 65 | 20 64 61 74 61 2e 20 54 |s in the| data. T|
|00004600| 68 65 20 76 61 6c 75 65 | 73 20 6f 66 20 63 68 65 |he value|s of che|
|00004610| 63 6b 62 6f 78 65 73 2c | 20 65 6e 61 62 6c 65 64 |ckboxes,| enabled|
|00004620| 20 62 75 74 74 6f 6e 73 | 20 69 6e 20 72 61 64 69 | buttons| in radi|
|00004630| 6f 20 62 75 74 74 6f 6e | 20 67 72 6f 75 70 73 2c |o button| groups,|
|00004640| 20 61 6e 64 20 70 6f 70 | 2d 75 70 20 6d 65 6e 75 | and pop|-up menu|
|00004650| 73 20 61 72 65 20 73 74 | 6f 72 65 64 20 61 73 20 |s are st|ored as |
|00004660| 31 36 2d 62 69 74 20 69 | 6e 74 65 67 65 72 73 2e |16-bit i|ntegers.|
|00004670| 20 52 65 74 75 72 6e 20 | 63 6f 64 65 73 20 61 72 | Return |codes ar|
|00004680| 65 20 64 65 66 69 6e 65 | 64 20 69 6e 20 74 68 65 |e define|d in the|
|00004690| 20 68 65 61 64 65 72 20 | 66 69 6c 65 2e 20 45 72 | header |file. Er|
|000046a0| 72 6f 72 73 20 61 72 65 | 20 72 65 74 75 72 6e 65 |rors are| returne|
|000046b0| 64 20 66 6f 72 20 69 6e | 76 61 6c 69 64 20 70 61 |d for in|valid pa|
|000046c0| 6e 65 20 61 6e 64 20 69 | 74 65 6d 20 6e 75 6d 62 |ne and i|tem numb|
|000046d0| 65 72 73 20 61 6e 64 20 | 62 75 66 66 65 72 20 6c |ers and |buffer l|
|000046e0| 65 6e 67 74 68 73 2e 20 | 0d 54 68 65 20 72 6f 75 |engths. |.The rou|
|000046f0| 74 69 6e 65 73 20 61 72 | 65 20 64 65 63 6c 61 72 |tines ar|e declar|
|00004700| 65 64 20 61 73 20 66 6f | 6c 6c 6f 77 73 3a 20 0d |ed as fo|llows: .|
|00004710| 73 68 6f 72 74 20 47 65 | 74 4d 50 44 49 74 65 6d |short Ge|tMPDItem|
|00004720| 28 48 61 6e 64 6c 65 20 | 74 68 65 44 61 74 61 2c |(Handle |theData,|
|00004730| 20 73 68 6f 72 74 20 70 | 61 6e 65 2c 20 73 68 6f | short p|ane, sho|
|00004740| 72 74 20 69 74 65 6d 2c | 20 50 74 72 20 70 74 72 |rt item,| Ptr ptr|
|00004750| 2c 20 0d 09 73 68 6f 72 | 74 20 6c 65 6e 29 0d 73 |, ..shor|t len).s|
|00004760| 68 6f 72 74 20 53 65 74 | 4d 50 44 49 74 65 6d 28 |hort Set|MPDItem(|
|00004770| 48 61 6e 64 6c 65 20 74 | 68 65 44 61 74 61 2c 20 |Handle t|heData, |
|00004780| 73 68 6f 72 74 20 70 61 | 6e 65 2c 20 73 68 6f 72 |short pa|ne, shor|
|00004790| 74 20 69 74 65 6d 2c 20 | 50 74 72 20 70 74 72 2c |t item, |Ptr ptr,|
|000047a0| 0d 09 73 68 6f 72 74 20 | 6c 65 6e 29 0d 54 68 65 |..short |len).The|
|000047b0| 20 73 61 6d 70 6c 65 20 | 61 70 70 6c 69 63 61 74 | sample |applicat|
|000047c0| 69 6f 6e 2c 20 69 6e 20 | 74 68 65 20 63 6f 64 65 |ion, in |the code|
|000047d0| 20 66 6f 72 20 44 69 61 | 6c 6f 67 44 69 73 70 6c | for Dia|logDispl|
|000047e0| 61 79 2c 20 70 72 6f 76 | 69 64 65 73 20 61 20 62 |ay, prov|ides a b|
|000047f0| 61 73 69 63 20 65 78 61 | 6d 70 6c 65 20 6f 66 20 |asic exa|mple of |
|00004800| 74 68 65 20 75 73 65 20 | 6f 66 20 74 68 65 73 65 |the use |of these|
|00004810| 20 72 6f 75 74 69 6e 65 | 73 20 74 6f 20 64 69 73 | routine|s to dis|
|00004820| 70 6c 61 79 20 74 68 65 | 20 63 75 72 72 65 6e 74 |play the| current|
|00004830| 20 73 65 74 74 69 6e 67 | 73 20 6f 66 20 74 68 65 | setting|s of the|
|00004840| 20 63 6f 6e 74 72 6f 6c | 73 20 69 6e 20 74 68 65 | control|s in the|
|00004850| 20 70 72 65 76 69 6f 75 | 73 6c 79 20 63 6c 6f 73 | previou|sly clos|
|00004860| 65 64 20 64 69 61 6c 6f | 67 2e 0d 4e 6f 72 6d 61 |ed dialo|g..Norma|
|00004870| 6c 6c 79 2c 20 74 68 65 | 73 65 20 72 6f 75 74 69 |lly, the|se routi|
|00004880| 6e 65 73 20 73 68 6f 75 | 6c 64 20 62 65 20 73 75 |nes shou|ld be su|
|00004890| 66 66 69 63 69 65 6e 74 | 20 74 6f 20 61 63 63 65 |fficient| to acce|
|000048a0| 73 73 20 74 68 65 20 64 | 61 74 61 20 69 6e 20 74 |ss the d|ata in t|
|000048b0| 68 65 20 68 61 6e 64 6c | 65 2e 20 48 6f 77 65 76 |he handl|e. Howev|
|000048c0| 65 72 2c 20 74 68 6f 73 | 65 20 61 70 70 6c 69 63 |er, thos|e applic|
|000048d0| 61 74 69 6f 6e 73 20 66 | 6f 72 20 77 68 69 63 68 |ations f|or which|
|000048e0| 20 69 74 20 77 6f 75 6c | 64 20 62 65 20 6d 6f 72 | it woul|d be mor|
|000048f0| 65 20 65 66 66 69 63 69 | 65 6e 74 20 74 6f 20 6d |e effici|ent to m|
|00004900| 61 6e 69 70 75 6c 61 74 | 65 20 74 68 65 20 68 61 |anipulat|e the ha|
|00004910| 6e 64 6c 65 20 64 69 72 | 65 63 74 6c 79 20 63 61 |ndle dir|ectly ca|
|00004920| 6e 20 75 73 65 20 74 68 | 65 20 66 6f 6c 6c 6f 77 |n use th|e follow|
|00004930| 69 6e 67 20 66 6f 72 6d | 61 74 3a 0d 4c 61 73 74 |ing form|at:.Last|
|00004940| 20 4f 70 65 6e 20 50 61 | 6e 65 0d 4f 66 66 73 65 | Open Pa|ne.Offse|
|00004950| 74 20 74 6f 20 50 61 6e | 65 20 31 2c 20 4f 66 66 |t to Pan|e 1, Off|
|00004960| 73 65 74 20 74 6f 20 50 | 61 6e 65 20 32 2c 20 2e |set to P|ane 2, .|
|00004970| 2e 2e 2c 20 4f 66 66 73 | 65 74 20 74 6f 20 50 61 |.., Offs|et to Pa|
|00004980| 6e 65 20 6e 2c 20 4e 55 | 4c 4c 0d 28 50 61 6e 65 |ne n, NU|LL.(Pane|
|00004990| 20 31 29 20 4c 65 6e 67 | 74 68 20 6f 66 20 49 74 | 1) Leng|th of It|
|000049a0| 65 6d 20 31 2c 20 44 61 | 74 61 20 66 6f 72 20 49 |em 1, Da|ta for I|
|000049b0| 74 65 6d 20 31 2c 20 2e | 2e 2e 2c 20 4c 65 6e 67 |tem 1, .|.., Leng|
|000049c0| 74 68 20 6f 66 20 49 74 | 65 6d 20 6d 2c 20 44 61 |th of It|em m, Da|
|000049d0| 74 61 20 0d 09 66 6f 72 | 20 49 74 65 6d 20 6d 2c |ta ..for| Item m,|
|000049e0| 20 4e 55 4c 4c 0d 2e 2e | 2e 0d 28 50 61 6e 65 20 | NULL...|..(Pane |
|000049f0| 6e 29 20 4c 65 6e 67 74 | 68 20 6f 66 20 49 74 65 |n) Lengt|h of Ite|
|00004a00| 6d 20 31 2c 20 44 61 74 | 61 20 66 6f 72 20 49 74 |m 1, Dat|a for It|
|00004a10| 65 6d 20 31 2c 20 2e 2e | 2e 2c 20 4c 65 6e 67 74 |em 1, ..|., Lengt|
|00004a20| 68 20 6f 66 20 49 74 65 | 6d 20 6d 2c 20 44 61 74 |h of Ite|m m, Dat|
|00004a30| 61 20 0d 09 66 6f 72 20 | 49 74 65 6d 20 6d 2c 20 |a ..for |Item m, |
|00004a40| 4e 55 4c 4c 0d 54 68 65 | 20 4c 61 73 74 20 4f 70 |NULL.The| Last Op|
|00004a50| 65 6e 20 50 61 6e 65 20 | 61 6e 64 20 74 68 65 20 |en Pane |and the |
|00004a60| 4f 66 66 73 65 74 20 74 | 6f 20 50 61 6e 65 20 66 |Offset t|o Pane f|
|00004a70| 69 65 6c 64 73 20 61 72 | 65 20 61 6c 6c 20 6c 6f |ields ar|e all lo|
|00004a80| 6e 67 20 69 6e 74 65 67 | 65 72 73 20 61 6e 64 20 |ng integ|ers and |
|00004a90| 74 68 65 20 4c 65 6e 67 | 74 68 20 6f 66 20 49 74 |the Leng|th of It|
|00004aa0| 65 6d 20 66 69 65 6c 64 | 73 20 61 72 65 20 61 6c |em field|s are al|
|00004ab0| 6c 20 73 68 6f 72 74 20 | 69 6e 74 65 67 65 72 73 |l short |integers|
|00004ac0| 2e 20 54 68 65 20 4c 65 | 6e 67 74 68 20 6f 66 20 |. The Le|ngth of |
|00004ad0| 49 74 65 6d 20 76 61 6c | 75 65 20 64 6f 65 73 6e |Item val|ue doesn|
|00004ae0| d5 74 20 69 6e 63 6c 75 | 64 65 20 74 68 65 20 6c |.t inclu|de the l|
|00004af0| 65 6e 67 74 68 20 6f 66 | 20 69 74 73 65 6c 66 3b |ength of| itself;|
|00004b00| 20 74 6f 20 67 65 74 20 | 74 6f 20 74 68 65 20 6e | to get |to the n|
|00004b10| 65 78 74 20 66 69 65 6c | 64 20 79 6f 75 20 77 6f |ext fiel|d you wo|
|00004b20| 75 6c 64 20 61 64 64 0d | 4c 65 6e 67 74 68 20 6f |uld add.|Length o|
|00004b30| 66 20 49 74 65 6d 20 2b | 20 73 69 7a 65 6f 66 28 |f Item +| sizeof(|
|00004b40| 73 68 6f 72 74 29 0d 74 | 6f 20 74 68 65 20 70 6f |short).t|o the po|
|00004b50| 69 6e 74 65 72 2e 20 54 | 68 65 20 4c 61 73 74 20 |inter. T|he Last |
|00004b60| 4f 70 65 6e 20 50 61 6e | 65 20 66 69 65 6c 64 20 |Open Pan|e field |
|00004b70| 61 6c 6c 6f 77 73 20 74 | 68 65 20 6d 75 6c 74 69 |allows t|he multi|
|00004b80| 70 61 6e 65 20 64 69 61 | 6c 6f 67 20 63 6f 64 65 |pane dia|log code|
|00004b90| 20 74 6f 20 64 69 73 70 | 6c 61 79 20 74 68 65 20 | to disp|lay the |
|00004ba0| 64 69 61 6c 6f 67 20 77 | 69 74 68 20 74 68 65 20 |dialog w|ith the |
|00004bb0| 6c 61 73 74 20 70 61 6e | 65 20 74 68 65 20 75 73 |last pan|e the us|
|00004bc0| 65 72 20 68 61 64 20 6f | 70 65 6e 20 61 73 20 74 |er had o|pen as t|
|00004bd0| 68 65 20 63 75 72 72 65 | 6e 74 20 70 61 6e 65 2e |he curre|nt pane.|
|00004be0| 0d 54 68 61 74 d5 73 20 | 61 6c 6c 20 79 6f 75 20 |.That.s |all you |
|00004bf0| 6e 65 65 64 20 74 6f 20 | 6b 6e 6f 77 20 74 6f 20 |need to |know to |
|00004c00| 6d 61 6b 65 20 62 61 73 | 69 63 20 75 73 65 20 6f |make bas|ic use o|
|00004c10| 66 20 6d 75 6c 74 69 70 | 61 6e 65 20 64 69 61 6c |f multip|ane dial|
|00004c20| 6f 67 73 2e 20 42 75 74 | 20 79 6f 75 20 63 61 6e |ogs. But| you can|
|00004c30| 20 61 6c 73 6f 20 67 6f | 20 61 20 73 74 65 70 20 | also go| a step |
|00004c40| 66 75 72 74 68 65 72 3a | 20 79 6f 75 20 63 61 6e |further:| you can|
|00004c50| 20 63 75 73 74 6f 6d 69 | 7a 65 20 63 65 72 74 61 | customi|ze certa|
|00004c60| 69 6e 20 61 73 70 65 63 | 74 73 20 6f 66 20 61 20 |in aspec|ts of a |
|00004c70| 6d 75 6c 74 69 70 61 6e | 65 20 64 69 61 6c 6f 67 |multipan|e dialog|
|00004c80| 20 62 79 20 75 73 69 6e | 67 20 74 68 65 20 66 6f | by usin|g the fo|
|00004c90| 75 72 20 6f 70 74 69 6f | 6e 61 6c 20 70 61 72 61 |ur optio|nal para|
|00004ca0| 6d 65 74 65 72 73 20 74 | 6f 20 4f 70 65 6e 4d 50 |meters t|o OpenMP|
|00004cb0| 44 69 61 6c 6f 67 20 6d | 65 6e 74 69 6f 6e 65 64 |Dialog m|entioned|
|00004cc0| 20 61 62 6f 76 65 2e 0d | 43 55 53 54 4f 4d 49 5a | above..|CUSTOMIZ|
|00004cd0| 49 4e 47 20 57 49 54 48 | 20 4f 50 54 49 4f 4e 41 |ING WITH| OPTIONA|
|00004ce0| 4c 20 50 52 4f 43 45 44 | 55 52 45 53 0d 54 68 65 |L PROCED|URES.The|
|00004cf0| 20 73 65 63 6f 6e 64 20 | 74 68 72 6f 75 67 68 20 | second |through |
|00004d00| 66 69 66 74 68 20 70 61 | 72 61 6d 65 74 65 72 73 |fifth pa|rameters|
|00004d10| 20 74 6f 20 4f 70 65 6e | 4d 50 44 69 61 6c 6f 67 | to Open|MPDialog|
|00004d20| 20 63 61 6e 20 69 6e 64 | 69 63 61 74 65 20 61 63 | can ind|icate ac|
|00004d30| 74 69 6f 6e 20 70 72 6f | 63 65 64 75 72 65 73 20 |tion pro|cedures |
|00004d40| 74 68 61 74 20 63 75 73 | 74 6f 6d 69 7a 65 20 64 |that cus|tomize d|
|00004d50| 69 61 6c 6f 67 20 62 65 | 68 61 76 69 6f 72 20 62 |ialog be|havior b|
|00004d60| 79 20 72 65 73 70 6f 6e | 64 69 6e 67 20 74 6f 20 |y respon|ding to |
|00004d70| 63 65 72 74 61 69 6e 20 | 65 76 65 6e 74 73 2e 20 |certain |events. |
|00004d80| 41 20 76 61 6c 75 65 20 | 6f 66 20 4e 55 4c 4c 20 |A value |of NULL |
|00004d90| 66 6f 72 20 61 6e 79 20 | 6f 66 20 74 68 65 73 65 |for any |of these|
|00004da0| 20 70 61 72 61 6d 65 74 | 65 72 73 20 74 65 6c 6c | paramet|ers tell|
|00004db0| 73 20 74 68 65 20 61 70 | 70 6c 69 63 61 74 69 6f |s the ap|plicatio|
|00004dc0| 6e 20 74 6f 20 75 73 65 | 20 74 68 65 20 64 65 66 |n to use| the def|
|00004dd0| 61 75 6c 74 20 62 65 68 | 61 76 69 6f 72 2e 20 54 |ault beh|avior. T|
|00004de0| 6f 20 70 72 6f 76 69 64 | 65 20 63 75 73 74 6f 6d |o provid|e custom|
|00004df0| 20 62 65 68 61 76 69 6f | 72 2c 20 79 6f 75 20 77 | behavio|r, you w|
|00004e00| 6f 75 6c 64 20 70 61 73 | 73 20 61 20 75 6e 69 76 |ould pas|s a univ|
|00004e10| 65 72 73 61 6c 20 70 72 | 6f 63 65 64 75 72 65 20 |ersal pr|ocedure |
|00004e20| 70 6f 69 6e 74 65 72 20 | 69 6e 73 74 65 61 64 20 |pointer |instead |
|00004e30| 6f 66 20 4e 55 4c 4c 2e | 20 54 68 65 20 70 72 6f |of NULL.| The pro|
|00004e40| 63 65 64 75 72 65 73 20 | 63 61 6e 20 61 6c 73 6f |cedures |can also|
|00004e50| 20 61 6c 73 6f 20 62 65 | 20 63 68 61 6e 67 65 64 | also be| changed|
|00004e60| 20 64 79 6e 61 6d 69 63 | 61 6c 6c 79 2c 20 62 79 | dynamic|ally, by|
|00004e70| 20 63 61 6c 6c 69 6e 67 | 20 74 68 65 20 49 6e 73 | calling| the Ins|
|00004e80| 74 61 6c 6c 41 63 74 69 | 6f 6e 20 72 6f 75 74 69 |tallActi|on routi|
|00004e90| 6e 65 2e 20 0d 54 68 65 | 20 61 63 74 69 6f 6e 20 |ne. .The| action |
|00004ea0| 70 72 6f 63 65 64 75 72 | 65 73 20 61 6e 64 20 74 |procedur|es and t|
|00004eb0| 68 65 20 64 65 66 61 75 | 6c 74 20 61 63 74 69 6f |he defau|lt actio|
|00004ec0| 6e 73 20 61 72 65 20 61 | 73 20 66 6f 6c 6c 6f 77 |ns are a|s follow|
|00004ed0| 73 3a 0d a5 09 54 68 65 | 20 53 65 74 20 44 65 66 |s:...The| Set Def|
|00004ee0| 61 75 6c 74 73 20 61 63 | 74 69 6f 6e 20 70 72 6f |aults ac|tion pro|
|00004ef0| 63 65 64 75 72 65 20 28 | 70 61 72 61 6d 65 74 65 |cedure (|paramete|
|00004f00| 72 20 32 29 20 70 72 6f | 76 69 64 65 73 20 66 61 |r 2) pro|vides fa|
|00004f10| 63 74 6f 72 79 20 64 65 | 66 61 75 6c 74 73 20 66 |ctory de|faults f|
|00004f20| 6f 72 20 63 6f 6e 74 72 | 6f 6c 73 2e 20 54 68 65 |or contr|ols. The|
|00004f30| 20 64 65 66 61 75 6c 74 | 20 61 63 74 69 6f 6e 20 | default| action |
|00004f40| 69 73 20 74 6f 20 73 65 | 74 20 74 68 65 6d 20 74 |is to se|t them t|
|00004f50| 6f 20 30 2e 0d a5 09 54 | 68 65 20 43 6c 69 63 6b |o 0....T|he Click|
|00004f60| 20 61 63 74 69 6f 6e 20 | 70 72 6f 63 65 64 75 72 | action |procedur|
|00004f70| 65 20 28 70 61 72 61 6d | 65 74 65 72 20 33 29 20 |e (param|eter 3) |
|00004f80| 65 6e 61 62 6c 65 73 20 | 79 6f 75 20 74 6f 20 63 |enables |you to c|
|00004f90| 75 73 74 6f 6d 69 7a 65 | 20 74 68 65 20 61 63 74 |ustomize| the act|
|00004fa0| 69 6f 6e 73 20 72 65 73 | 75 6c 74 69 6e 67 20 66 |ions res|ulting f|
|00004fb0| 72 6f 6d 20 63 6c 69 63 | 6b 69 6e 67 20 61 20 63 |rom clic|king a c|
|00004fc0| 6f 6e 74 72 6f 6c 2c 20 | 73 75 63 68 20 61 73 20 |ontrol, |such as |
|00004fd0| 64 69 6d 6d 69 6e 67 20 | 6f 72 20 75 6e 64 69 6d |dimming |or undim|
|00004fe0| 6d 69 6e 67 20 6f 74 68 | 65 72 20 63 6f 6e 74 72 |ming oth|er contr|
|00004ff0| 6f 6c 73 20 6f 72 20 70 | 65 72 66 6f 72 6d 69 6e |ols or p|erformin|
|00005000| 67 20 64 61 74 61 20 76 | 61 6c 69 64 61 74 69 6f |g data v|alidatio|
|00005010| 6e 2e 20 54 68 65 20 64 | 65 66 61 75 6c 74 20 61 |n. The d|efault a|
|00005020| 63 74 69 6f 6e 20 69 73 | 20 74 6f 20 74 6f 67 67 |ction is| to togg|
|00005030| 6c 65 20 63 68 65 63 6b | 62 6f 78 65 73 20 61 6e |le check|boxes an|
|00005040| 64 20 68 61 6e 64 6c 65 | 20 72 61 64 69 6f 20 62 |d handle| radio b|
|00005050| 75 74 74 6f 6e 73 20 76 | 69 61 20 74 68 65 20 52 |uttons v|ia the R|
|00005060| 61 64 69 6f 20 47 72 6f | 75 70 20 61 63 74 69 6f |adio Gro|up actio|
|00005070| 6e 20 70 72 6f 63 65 64 | 75 72 65 2e 0d a5 09 54 |n proced|ure....T|
|00005080| 68 65 20 45 64 69 74 20 | 61 63 74 69 6f 6e 20 70 |he Edit |action p|
|00005090| 72 6f 63 65 64 75 72 65 | 20 28 70 61 72 61 6d 65 |rocedure| (parame|
|000050a0| 74 65 72 20 34 29 20 65 | 6e 61 62 6c 65 73 20 73 |ter 4) e|nables s|
|000050b0| 70 65 63 69 61 6c 20 68 | 61 6e 64 6c 69 6e 67 20 |pecial h|andling |
|000050c0| 6f 66 20 65 64 69 74 61 | 62 6c 65 20 74 65 78 74 |of edita|ble text|
|000050d0| 20 66 69 65 6c 64 73 2c | 20 73 75 63 68 20 61 73 | fields,| such as|
|000050e0| 20 63 6f 6e 76 65 72 74 | 69 6e 67 20 74 68 65 20 | convert|ing the |
|000050f0| 73 74 72 69 6e 67 20 74 | 6f 20 61 6e 20 69 6e 74 |string t|o an int|
|00005100| 65 67 65 72 2e 20 54 68 | 65 20 64 65 66 61 75 6c |eger. Th|e defaul|
|00005110| 74 20 61 63 74 69 6f 6e | 20 69 73 20 74 6f 20 73 |t action| is to s|
|00005120| 74 6f 72 65 20 74 68 65 | 20 65 6e 74 69 72 65 20 |tore the| entire |
|00005130| 73 74 72 69 6e 67 20 61 | 73 20 61 20 53 74 72 32 |string a|s a Str2|
|00005140| 35 35 2e 0d a5 09 54 68 | 65 20 52 61 64 69 6f 20 |55....Th|e Radio |
|00005150| 47 72 6f 75 70 20 61 63 | 74 69 6f 6e 20 70 72 6f |Group ac|tion pro|
|00005160| 63 65 64 75 72 65 20 28 | 70 61 72 61 6d 65 74 65 |cedure (|paramete|
|00005170| 72 20 35 29 20 65 6e 61 | 62 6c 65 73 20 79 6f 75 |r 5) ena|bles you|
|00005180| 20 74 6f 20 63 75 73 74 | 6f 6d 69 7a 65 20 74 68 | to cust|omize th|
|00005190| 65 20 62 65 68 61 76 69 | 6f 72 20 6f 66 20 72 61 |e behavi|or of ra|
|000051a0| 64 69 6f 20 62 75 74 74 | 6f 6e 20 67 72 6f 75 70 |dio butt|on group|
|000051b0| 73 2c 20 73 75 63 68 20 | 61 73 20 68 6f 77 20 74 |s, such |as how t|
|000051c0| 68 65 20 76 61 6c 75 65 | 73 20 61 72 65 20 73 74 |he value|s are st|
|000051d0| 6f 72 65 64 2e 20 54 68 | 65 20 64 65 66 61 75 6c |ored. Th|e defaul|
|000051e0| 74 20 61 63 74 69 6f 6e | 20 69 73 20 74 6f 20 73 |t action| is to s|
|000051f0| 74 6f 72 65 20 74 68 65 | 20 76 61 6c 75 65 20 61 |tore the| value a|
|00005200| 73 20 74 68 65 20 69 6e | 64 65 78 20 6e 75 6d 62 |s the in|dex numb|
|00005210| 65 72 20 6f 66 20 74 68 | 65 20 72 61 64 69 6f 20 |er of th|e radio |
|00005220| 62 75 74 74 6f 6e 20 74 | 68 61 74 d5 73 20 65 6e |button t|hat.s en|
|00005230| 61 62 6c 65 64 20 69 6e | 20 74 68 65 20 67 72 6f |abled in| the gro|
|00005240| 75 70 3b 20 74 68 65 20 | 64 65 66 61 75 6c 74 20 |up; the |default |
|00005250| 76 61 6c 75 65 20 69 73 | 20 31 20 28 74 68 65 20 |value is| 1 (the |
|00005260| 66 69 72 73 74 20 72 61 | 64 69 6f 20 62 75 74 74 |first ra|dio butt|
|00005270| 6f 6e 20 69 6e 20 74 68 | 65 20 67 72 6f 75 70 29 |on in th|e group)|
|00005280| 2e 0d 41 6c 6c 20 74 68 | 65 20 61 63 74 69 6f 6e |..All th|e action|
|00005290| 20 70 72 6f 63 65 64 75 | 72 65 20 70 6f 69 6e 74 | procedu|re point|
|000052a0| 65 72 73 20 61 72 65 20 | 64 65 63 6c 61 72 65 64 |ers are |declared|
|000052b0| 20 61 73 20 55 6e 69 76 | 65 72 73 61 6c 50 72 6f | as Univ|ersalPro|
|000052c0| 63 50 74 72 73 20 66 6f | 72 20 63 6f 6d 70 61 74 |cPtrs fo|r compat|
|000052d0| 69 62 69 6c 69 74 79 20 | 69 6e 20 63 61 73 65 20 |ibility |in case |
|000052e0| 6f 66 20 50 6f 77 65 72 | 50 43 20 63 6f 6d 70 69 |of Power|PC compi|
|000052f0| 6c 61 74 69 6f 6e 2c 20 | 73 6f 20 74 68 65 79 20 |lation, |so they |
|00005300| 6d 75 73 74 20 62 65 20 | 61 6c 6c 6f 63 61 74 65 |must be |allocate|
|00005310| 64 20 62 65 66 6f 72 65 | 20 75 73 65 2e 20 54 68 |d before| use. Th|
|00005320| 65 20 73 61 6d 70 6c 65 | 20 70 72 6f 67 72 61 6d |e sample| program|
|00005330| 20 64 6f 65 73 20 74 68 | 69 73 20 62 79 20 64 65 | does th|is by de|
|00005340| 63 6c 61 72 69 6e 67 20 | 61 20 55 6e 69 76 65 72 |claring |a Univer|
|00005350| 73 61 6c 50 72 6f 63 50 | 74 72 20 66 6f 72 20 65 |salProcP|tr for e|
|00005360| 61 63 68 20 64 65 73 69 | 72 65 64 20 61 63 74 69 |ach desi|red acti|
|00005370| 6f 6e 20 70 72 6f 63 65 | 64 75 72 65 2e 20 46 6f |on proce|dure. Fo|
|00005380| 72 20 65 78 61 6d 70 6c | 65 2c 20 74 68 65 20 6f |r exampl|e, the o|
|00005390| 6e 65 20 66 6f 72 20 74 | 68 65 20 43 6c 69 63 6b |ne for t|he Click|
|000053a0| 20 61 63 74 69 6f 6e 20 | 70 72 6f 63 65 64 75 72 | action |procedur|
|000053b0| 65 20 69 73 20 64 65 63 | 6c 61 72 65 64 20 61 73 |e is dec|lared as|
|000053c0| 20 66 6f 6c 6c 6f 77 73 | 3a 0d 43 6c 69 63 6b 41 | follows|:.ClickA|
|000053d0| 63 74 69 6f 6e 55 50 50 | 20 6d 79 43 6c 69 63 6b |ctionUPP| myClick|
|000053e0| 41 63 74 69 6f 6e 20 3d | 20 4e 55 4c 4c 3b 0d 49 |Action =| NULL;.I|
|000053f0| 74 d5 73 20 69 6e 69 74 | 69 61 6c 69 7a 65 64 20 |t.s init|ialized |
|00005400| 69 6e 20 74 68 65 20 6d | 61 69 6e 20 72 6f 75 74 |in the m|ain rout|
|00005410| 69 6e 65 20 6f 66 20 74 | 68 65 20 61 70 70 6c 69 |ine of t|he appli|
|00005420| 63 61 74 69 6f 6e 20 6c | 69 6b 65 20 74 68 69 73 |cation l|ike this|
|00005430| 3a 0d 6d 79 43 6c 69 63 | 6b 41 63 74 69 6f 6e 20 |:.myClic|kAction |
|00005440| 3d 20 4e 65 77 43 6c 69 | 63 6b 41 63 74 69 6f 6e |= NewCli|ckAction|
|00005450| 50 72 6f 63 28 4d 79 43 | 6c 69 63 6b 41 63 74 69 |Proc(MyC|lickActi|
|00005460| 6f 6e 29 3b 0d 44 65 70 | 65 6e 64 69 6e 67 20 6f |on);.Dep|ending o|
|00005470| 6e 20 77 68 61 74 20 79 | 6f 75 20 77 61 6e 74 20 |n what y|ou want |
|00005480| 74 6f 20 64 6f 20 69 6e | 20 74 68 65 20 61 63 74 |to do in| the act|
|00005490| 69 6f 6e 20 70 72 6f 63 | 65 64 75 72 65 73 2c 20 |ion proc|edures, |
|000054a0| 79 6f 75 20 6d 61 79 20 | 6e 65 65 64 20 74 6f 20 |you may |need to |
|000054b0| 6d 61 6b 65 20 75 73 65 | 20 6f 66 20 74 68 65 20 |make use| of the |
|000054c0| 4d 50 44 48 64 6c 20 73 | 74 6f 72 65 64 20 69 6e |MPDHdl s|tored in|
|000054d0| 20 74 68 65 20 64 69 61 | 6c 6f 67 d5 73 20 72 65 | the dia|log.s re|
|000054e0| 66 43 6f 6e 2c 20 6d 65 | 6e 74 69 6f 6e 65 64 20 |fCon, me|ntioned |
|000054f0| 65 61 72 6c 69 65 72 2e | 20 54 68 69 73 20 69 73 |earlier.| This is|
|00005500| 20 74 68 65 20 6d 61 69 | 6e 20 64 61 74 61 20 73 | the mai|n data s|
|00005510| 74 72 75 63 74 75 72 65 | 20 75 73 65 64 20 62 79 |tructure| used by|
|00005520| 20 74 68 65 20 6d 75 6c | 74 69 70 61 6e 65 20 64 | the mul|tipane d|
|00005530| 69 61 6c 6f 67 20 63 6f | 64 65 20 66 6f 72 20 73 |ialog co|de for s|
|00005540| 74 61 74 65 20 69 6e 66 | 6f 72 6d 61 74 69 6f 6e |tate inf|ormation|
|00005550| 2e 20 49 74 d5 73 20 64 | 65 66 69 6e 65 64 20 6c |. It.s d|efined l|
|00005560| 69 6b 65 20 74 68 69 73 | 3a 0d 74 79 70 65 64 65 |ike this|:.typede|
|00005570| 66 20 73 74 72 75 63 74 | 20 4d 50 44 52 65 63 20 |f struct| MPDRec |
|00005580| 7b 0d 09 73 68 6f 72 74 | 09 09 09 6e 75 6d 50 61 |{..short|...numPa|
|00005590| 6e 65 73 3b 09 09 2f 2f | 20 4e 75 6d 62 65 72 20 |nes;..//| Number |
|000055a0| 6f 66 20 70 61 6e 65 73 | 20 69 6e 20 74 68 65 20 |of panes| in the |
|000055b0| 64 69 61 6c 6f 67 0d 09 | 73 68 6f 72 74 09 09 09 |dialog..|short...|
|000055c0| 63 75 72 72 65 6e 74 50 | 61 6e 65 3b 09 2f 2f 20 |currentP|ane;.// |
|000055d0| 43 75 72 72 65 6e 74 20 | 70 61 6e 65 20 62 65 69 |Current |pane bei|
|000055e0| 6e 67 20 64 69 73 70 6c | 61 79 65 64 20 0d 09 73 |ng displ|ayed ..s|
|000055f0| 68 6f 72 74 09 09 09 62 | 61 73 65 49 74 65 6d 73 |hort...b|aseItems|
|00005600| 3b 09 09 2f 2f 20 49 74 | 65 6d 20 6e 75 6d 62 65 |;..// It|em numbe|
|00005610| 72 20 6f 66 20 66 69 72 | 73 74 20 69 74 65 6d 20 |r of fir|st item |
|00005620| 69 6e 20 74 68 65 20 70 | 61 6e 65 73 0d 09 73 68 |in the p|anes..sh|
|00005630| 6f 72 74 09 09 09 2a 70 | 61 6e 65 49 44 73 3b 09 |ort...*p|aneIDs;.|
|00005640| 09 2f 2f 20 4c 69 73 74 | 20 6f 66 20 49 44 73 20 |.// List| of IDs |
|00005650| 66 6f 72 20 74 68 65 20 | 70 61 6e 65 27 73 20 44 |for the |pane's D|
|00005660| 49 54 4c 73 0d 09 73 68 | 6f 72 74 09 09 09 70 61 |ITLs..sh|ort...pa|
|00005670| 6e 65 44 69 72 74 79 3b | 09 09 2f 2f 20 57 68 65 |neDirty;|..// Whe|
|00005680| 74 68 65 72 20 52 65 76 | 65 72 74 20 73 68 6f 75 |ther Rev|ert shou|
|00005690| 6c 64 20 62 65 20 65 6e | 61 62 6c 65 64 0d 09 52 |ld be en|abled..R|
|000056a0| 61 64 69 6f 47 72 6f 75 | 70 50 74 72 09 72 61 64 |adioGrou|pPtr.rad|
|000056b0| 69 6f 3b 09 09 09 2f 2f | 20 4c 69 6e 6b 65 64 20 |io;...//| Linked |
|000056c0| 6c 69 73 74 20 6f 66 20 | 72 61 64 69 6f 20 62 75 |list of |radio bu|
|000056d0| 74 74 6f 6e 20 67 72 6f | 75 70 73 0d 09 48 61 6e |tton gro|ups..Han|
|000056e0| 64 6c 65 09 09 09 74 68 | 65 44 61 74 61 3b 09 09 |dle...th|eData;..|
|000056f0| 2f 2f 20 41 63 74 75 61 | 6c 20 73 74 6f 72 61 67 |// Actua|l storag|
|00005700| 65 20 66 6f 72 20 64 69 | 61 6c 6f 67 20 76 61 6c |e for di|alog val|
|00005710| 75 65 73 0d 09 48 61 6e | 64 6c 65 09 09 09 74 6d |ues..Han|dle...tm|
|00005720| 70 44 61 74 61 3b 09 09 | 2f 2f 20 54 65 6d 70 6f |pData;..|// Tempo|
|00005730| 72 61 72 79 20 73 74 6f | 72 61 67 65 20 66 6f 72 |rary sto|rage for|
|00005740| 20 64 69 61 6c 6f 67 20 | 76 61 6c 75 65 73 0d 09 | dialog |values..|
|00005750| 48 61 6e 64 6c 65 09 09 | 09 2a 49 63 6f 6e 48 61 |Handle..|.*IconHa|
|00005760| 6e 64 6c 65 73 3b 09 2f | 2f 20 4c 69 73 74 20 6f |ndles;./|/ List o|
|00005770| 66 20 69 63 6f 6e 20 73 | 75 69 74 65 73 0d 09 4c |f icon s|uites..L|
|00005780| 69 73 74 48 61 6e 64 6c | 65 09 09 74 68 65 4c 69 |istHandl|e..theLi|
|00005790| 73 74 3b 09 09 2f 2f 20 | 4c 69 73 74 20 4d 61 6e |st;..// |List Man|
|000057a0| 61 67 65 72 20 6c 69 73 | 74 20 66 6f 72 20 74 68 |ager lis|t for th|
|000057b0| 65 20 69 63 6f 6e 20 6c | 69 73 74 0d 09 43 6c 69 |e icon l|ist..Cli|
|000057c0| 63 6b 41 63 74 69 6f 6e | 55 50 50 20 43 6c 69 63 |ckAction|UPP Clic|
|000057d0| 6b 41 63 74 69 6f 6e 3b | 09 2f 2f 20 41 63 74 69 |kAction;|.// Acti|
|000057e0| 6f 6e 20 70 72 6f 63 65 | 64 75 72 65 73 0d 09 45 |on proce|dures..E|
|000057f0| 64 69 74 41 63 74 69 6f | 6e 55 50 50 20 20 45 64 |ditActio|nUPP Ed|
|00005800| 69 74 41 63 74 69 6f 6e | 3b 0d 09 47 72 6f 75 70 |itAction|;..Group|
|00005810| 41 63 74 69 6f 6e 55 50 | 50 20 47 72 6f 75 70 41 |ActionUP|P GroupA|
|00005820| 63 74 69 6f 6e 3b 0d 09 | 44 65 66 41 63 74 69 6f |ction;..|DefActio|
|00005830| 6e 55 50 50 20 20 20 44 | 65 66 41 63 74 69 6f 6e |nUPP D|efAction|
|00005840| 3b 20 0d 7d 20 4d 50 44 | 52 65 63 2c 20 2a 4d 50 |; .} MPD|Rec, *MP|
|00005850| 44 50 74 72 2c 20 2a 2a | 4d 50 44 48 64 6c 3b 0d |DPtr, **|MPDHdl;.|
|00005860| 4e 6f 6e 65 20 6f 66 20 | 74 68 65 20 65 6c 65 6d |None of |the elem|
|00005870| 65 6e 74 73 20 6f 66 20 | 74 68 69 73 20 73 74 72 |ents of |this str|
|00005880| 75 63 74 75 72 65 20 73 | 68 6f 75 6c 64 20 62 65 |ucture s|hould be|
|00005890| 20 6d 6f 64 69 66 69 65 | 64 20 62 79 20 75 73 65 | modifie|d by use|
|000058a0| 72 20 63 6f 64 65 2e 20 | 54 68 65 20 66 6f 75 72 |r code. |The four|
|000058b0| 20 55 50 50 20 66 69 65 | 6c 64 73 20 63 61 6e 20 | UPP fie|lds can |
|000058c0| 62 65 20 6d 61 6e 69 70 | 75 6c 61 74 65 64 20 76 |be manip|ulated v|
|000058d0| 69 61 20 63 61 6c 6c 73 | 20 74 6f 20 49 6e 73 74 |ia calls| to Inst|
|000058e0| 61 6c 6c 41 63 74 69 6f | 6e 20 61 6e 64 20 52 65 |allActio|n and Re|
|000058f0| 6d 6f 76 65 41 63 74 69 | 6f 6e 2e 20 0d 54 68 65 |moveActi|on. .The|
|00005900| 20 62 61 73 65 49 74 65 | 6d 73 20 66 69 65 6c 64 | baseIte|ms field|
|00005910| 20 77 69 6c 6c 20 62 65 | 20 74 68 65 20 6d 6f 73 | will be| the mos|
|00005920| 74 20 75 73 65 66 75 6c | 20 69 6e 20 74 68 65 20 |t useful| in the |
|00005930| 61 63 74 69 6f 6e 20 70 | 72 6f 63 65 64 75 72 65 |action p|rocedure|
|00005940| 73 2e 20 49 74 20 68 6f | 6c 64 73 20 74 68 65 20 |s. It ho|lds the |
|00005950| 69 74 65 6d 20 6e 75 6d | 62 65 72 20 6f 66 20 74 |item num|ber of t|
|00005960| 68 65 20 66 69 72 73 74 | 20 69 74 65 6d 20 69 6e |he first| item in|
|00005970| 20 74 68 65 20 70 61 6e | 65 2c 20 77 68 69 63 68 | the pan|e, which|
|00005980| 20 69 73 20 74 68 65 20 | 68 69 64 64 65 6e 20 73 | is the |hidden s|
|00005990| 74 61 74 69 63 20 74 65 | 78 74 20 69 74 65 6d 20 |tatic te|xt item |
|000059a0| 75 73 65 64 20 66 6f 72 | 20 43 6f 6d 6d 61 6e 64 |used for| Command|
|000059b0| 2d 6b 65 79 20 65 71 75 | 69 76 61 6c 65 6e 74 73 |-key equ|ivalents|
|000059c0| 2e 20 54 68 75 73 2c 20 | 69 66 20 64 61 74 61 48 |. Thus, |if dataH|
|000059d0| 20 69 73 20 6f 66 20 74 | 79 70 65 20 4d 50 44 48 | is of t|ype MPDH|
|000059e0| 64 6c 2c 20 74 68 65 20 | 69 6e 64 65 78 20 6f 66 |dl, the |index of|
|000059f0| 20 74 68 65 20 66 69 72 | 73 74 20 72 65 61 6c 20 | the fir|st real |
|00005a00| 63 6f 6e 74 72 6f 6c 20 | 28 74 68 65 20 73 65 63 |control |(the sec|
|00005a10| 6f 6e 64 20 44 49 54 4c | 20 65 6e 74 72 79 29 20 |ond DITL| entry) |
|00005a20| 69 6e 20 74 68 65 20 70 | 61 6e 65 20 77 69 6c 6c |in the p|ane will|
|00005a30| 20 62 65 20 28 2a 64 61 | 74 61 48 29 2d 3e 62 61 | be (*da|taH)->ba|
|00005a40| 73 65 49 74 65 6d 73 20 | 2b 20 31 2e 20 0d 4e 6f |seItems |+ 1. .No|
|00005a50| 77 20 6c 65 74 d5 73 20 | 74 61 6b 65 20 61 20 63 |w let.s |take a c|
|00005a60| 6c 6f 73 65 72 20 6c 6f | 6f 6b 20 61 74 20 65 61 |loser lo|ok at ea|
|00005a70| 63 68 20 6f 66 20 74 68 | 65 20 61 63 74 69 6f 6e |ch of th|e action|
|00005a80| 20 70 72 6f 63 65 64 75 | 72 65 73 2e 20 0d 54 48 | procedu|res. .TH|
|00005a90| 45 20 53 45 54 20 44 45 | 46 41 55 4c 54 53 20 41 |E SET DE|FAULTS A|
|00005aa0| 43 54 49 4f 4e 20 50 52 | 4f 43 45 44 55 52 45 0d |CTION PR|OCEDURE.|
|00005ab0| 54 68 65 20 53 65 74 20 | 44 65 66 61 75 6c 74 73 |The Set |Defaults|
|00005ac0| 20 61 63 74 69 6f 6e 20 | 70 72 6f 63 65 64 75 72 | action |procedur|
|00005ad0| 65 20 70 72 6f 76 69 64 | 65 73 20 66 61 63 74 6f |e provid|es facto|
|00005ae0| 72 79 20 64 65 66 61 75 | 6c 74 73 20 66 6f 72 20 |ry defau|lts for |
|00005af0| 63 68 65 63 6b 62 6f 78 | 65 73 20 61 6e 64 20 6f |checkbox|es and o|
|00005b00| 74 68 65 72 20 63 6f 6e | 74 72 6f 6c 73 2c 20 65 |ther con|trols, e|
|00005b10| 78 63 65 70 74 20 66 6f | 72 20 72 61 64 69 6f 20 |xcept fo|r radio |
|00005b20| 62 75 74 74 6f 6e 20 67 | 72 6f 75 70 73 20 28 68 |button g|roups (h|
|00005b30| 61 6e 64 6c 65 64 20 69 | 6e 20 74 68 65 20 52 61 |andled i|n the Ra|
|00005b40| 64 69 6f 20 47 72 6f 75 | 70 20 61 63 74 69 6f 6e |dio Grou|p action|
|00005b50| 20 70 72 6f 63 65 64 75 | 72 65 29 2e 20 49 74 d5 | procedu|re). It.|
|00005b60| 73 20 63 61 6c 6c 65 64 | 20 77 69 74 68 20 61 20 |s called| with a |
|00005b70| 70 6f 69 6e 74 65 72 20 | 74 6f 20 d1 20 61 6e 64 |pointer |to . and|
|00005b80| 20 74 68 65 20 6c 65 6e | 67 74 68 20 6f 66 20 d1 | the len|gth of .|
|00005b90| 20 61 20 62 75 66 66 65 | 72 20 68 6f 6c 64 69 6e | a buffe|r holdin|
|00005ba0| 67 20 74 68 65 20 69 6e | 74 65 72 6e 61 6c 20 72 |g the in|ternal r|
|00005bb0| 65 70 72 65 73 65 6e 74 | 61 74 69 6f 6e 20 6f 66 |epresent|ation of|
|00005bc0| 20 74 68 65 20 76 61 6c | 75 65 20 6f 66 20 61 20 | the val|ue of a |
|00005bd0| 73 69 6e 67 6c 65 20 63 | 6f 6e 74 72 6f 6c 20 63 |single c|ontrol c|
|00005be0| 6f 72 72 65 73 70 6f 6e | 64 69 6e 67 20 74 6f 20 |orrespon|ding to |
|00005bf0| 61 20 73 70 65 63 69 66 | 69 63 20 70 61 6e 65 20 |a specif|ic pane |
|00005c00| 61 6e 64 20 69 74 65 6d | 20 6e 75 6d 62 65 72 2e |and item| number.|
|00005c10| 20 59 6f 75 20 63 61 6e | 20 63 61 6c 6c 20 44 65 | You can| call De|
|00005c20| 66 61 75 6c 74 41 63 74 | 69 6f 6e 20 74 6f 20 74 |faultAct|ion to t|
|00005c30| 61 6b 65 20 74 68 65 20 | 64 65 66 61 75 6c 74 20 |ake the |default |
|00005c40| 61 63 74 69 6f 6e 20 66 | 6f 72 20 69 74 65 6d 73 |action f|or items|
|00005c50| 20 79 6f 75 72 20 63 6f | 64 65 20 64 6f 65 73 6e | your co|de doesn|
|00005c60| d5 74 20 68 61 6e 64 6c | 65 2e 20 0d 54 68 65 20 |.t handl|e. .The |
|00005c70| 70 72 6f 63 65 64 75 72 | 65 20 69 73 20 64 65 63 |procedur|e is dec|
|00005c80| 6c 61 72 65 64 20 6c 69 | 6b 65 20 74 68 69 73 3a |lared li|ke this:|
|00005c90| 20 0d 76 6f 69 64 20 4d | 79 53 65 74 44 65 66 41 | .void M|ySetDefA|
|00005ca0| 63 74 69 6f 6e 28 50 74 | 72 20 74 68 65 44 61 74 |ction(Pt|r theDat|
|00005cb0| 61 2c 20 73 68 6f 72 74 | 20 6c 65 6e 2c 20 73 68 |a, short| len, sh|
|00005cc0| 6f 72 74 20 69 54 79 70 | 65 2c 20 73 68 6f 72 74 |ort iTyp|e, short|
|00005cd0| 20 70 61 6e 65 2c 20 0d | 09 73 68 6f 72 74 20 69 | pane, .|.short i|
|00005ce0| 74 65 6d 29 0d 54 68 65 | 20 53 65 74 20 44 65 66 |tem).The| Set Def|
|00005cf0| 61 75 6c 74 73 20 61 63 | 74 69 6f 6e 20 70 72 6f |aults ac|tion pro|
|00005d00| 63 65 64 75 72 65 d5 73 | 20 64 65 66 61 75 6c 74 |cedure.s| default|
|00005d10| 73 20 66 6f 72 20 72 61 | 64 69 6f 20 62 75 74 74 |s for ra|dio butt|
|00005d20| 6f 6e 73 20 61 70 70 6c | 79 20 6f 6e 6c 79 20 74 |ons appl|y only t|
|00005d30| 6f 20 74 68 6f 73 65 20 | 74 68 61 74 20 61 72 65 |o those |that are|
|00005d40| 6e d5 74 20 70 61 72 74 | 20 6f 66 20 61 20 72 61 |n.t part| of a ra|
|00005d50| 64 69 6f 20 62 75 74 74 | 6f 6e 20 67 72 6f 75 70 |dio butt|on group|
|00005d60| 2e 20 42 75 74 20 75 73 | 69 6e 67 20 73 69 6e 67 |. But us|ing sing|
|00005d70| 6c 65 20 72 61 64 69 6f | 20 62 75 74 74 6f 6e 73 |le radio| buttons|
|00005d80| 20 69 73 20 64 65 66 69 | 6e 69 74 65 6c 79 20 6e | is defi|nitely n|
|00005d90| 6f 74 20 61 64 76 69 73 | 65 64 3b 20 61 6c 6c 20 |ot advis|ed; all |
|00005da0| 72 61 64 69 6f 20 62 75 | 74 74 6f 6e 73 20 73 68 |radio bu|ttons sh|
|00005db0| 6f 75 6c 64 20 62 65 20 | 69 6e 20 67 72 6f 75 70 |ould be |in group|
|00005dc0| 73 20 74 6f 20 62 65 20 | 63 6f 6e 73 69 73 74 65 |s to be |consiste|
|00005dd0| 6e 74 20 77 69 74 68 20 | 74 68 65 20 4d 61 63 69 |nt with |the Maci|
|00005de0| 6e 74 6f 73 68 20 48 75 | 6d 61 6e 20 49 6e 74 65 |ntosh Hu|man Inte|
|00005df0| 72 66 61 63 65 20 47 75 | 69 64 65 6c 69 6e 65 73 |rface Gu|idelines|
|00005e00| 2e 20 0d 54 48 45 20 43 | 4c 49 43 4b 20 41 43 54 |. .THE C|LICK ACT|
|00005e10| 49 4f 4e 20 50 52 4f 43 | 45 44 55 52 45 0d 54 68 |ION PROC|EDURE.Th|
|00005e20| 65 20 43 6c 69 63 6b 20 | 61 63 74 69 6f 6e 20 70 |e Click |action p|
|00005e30| 72 6f 63 65 64 75 72 65 | 20 65 6e 61 62 6c 65 73 |rocedure| enables|
|00005e40| 20 79 6f 75 20 74 6f 20 | 63 75 73 74 6f 6d 69 7a | you to |customiz|
|00005e50| 65 20 74 68 65 20 61 63 | 74 69 6f 6e 73 20 72 65 |e the ac|tions re|
|00005e60| 73 75 6c 74 69 6e 67 20 | 66 72 6f 6d 20 63 6c 69 |sulting |from cli|
|00005e70| 63 6b 69 6e 67 20 61 20 | 63 6f 6e 74 72 6f 6c 2e |cking a |control.|
|00005e80| 20 46 6f 72 20 69 6e 73 | 74 61 6e 63 65 2c 20 74 | For ins|tance, t|
|00005e90| 68 69 73 20 70 72 6f 63 | 65 64 75 72 65 20 63 61 |his proc|edure ca|
|00005ea0| 6e 20 68 61 6e 64 6c 65 | 20 64 69 6d 6d 69 6e 67 |n handle| dimming|
|00005eb0| 20 6f 72 20 75 6e 64 69 | 6d 6d 69 6e 67 20 6f 74 | or undi|mming ot|
|00005ec0| 68 65 72 20 63 6f 6e 74 | 72 6f 6c 73 20 77 68 65 |her cont|rols whe|
|00005ed0| 6e 20 63 65 72 74 61 69 | 6e 20 63 68 65 63 6b 62 |n certai|n checkb|
|00005ee0| 6f 78 65 73 20 61 72 65 | 20 63 6c 69 63 6b 65 64 |oxes are| clicked|
|00005ef0| 2e 20 49 74 20 63 61 6e | 20 61 6c 73 6f 20 70 72 |. It can| also pr|
|00005f00| 6f 76 69 64 65 20 76 61 | 6c 69 64 61 74 69 6f 6e |ovide va|lidation|
|00005f10| 20 66 6f 72 20 63 6f 6e | 74 72 6f 6c 20 73 65 74 | for con|trol set|
|00005f20| 74 69 6e 67 73 20 77 68 | 65 6e 20 74 68 65 20 75 |tings wh|en the u|
|00005f30| 73 65 72 20 74 72 69 65 | 73 20 74 6f 20 63 68 61 |ser trie|s to cha|
|00005f40| 6e 67 65 20 74 68 65 20 | 70 61 6e 65 20 6f 72 20 |nge the |pane or |
|00005f50| 63 6c 69 63 6b 20 4f 4b | 2c 20 74 6f 20 65 6e 73 |click OK|, to ens|
|00005f60| 75 72 65 20 74 68 61 74 | 20 0d 74 68 65 20 65 6e |ure that| .the en|
|00005f70| 74 65 72 65 64 20 73 65 | 74 74 69 6e 67 73 20 6d |tered se|ttings m|
|00005f80| 61 6b 65 20 73 65 6e 73 | 65 2e 20 54 68 65 20 70 |ake sens|e. The p|
|00005f90| 72 6f 63 65 64 75 72 65 | 20 72 65 63 65 69 76 65 |rocedure| receive|
|00005fa0| 73 20 61 20 44 69 61 6c | 6f 67 50 74 72 20 61 6e |s a Dial|ogPtr an|
|00005fb0| 64 20 74 68 65 20 70 61 | 6e 65 20 61 6e 64 20 69 |d the pa|ne and i|
|00005fc0| 74 65 6d 20 6e 75 6d 62 | 65 72 73 2e 20 49 74 d5 |tem numb|ers. It.|
|00005fd0| 73 20 64 65 63 6c 61 72 | 65 64 20 61 73 20 66 6f |s declar|ed as fo|
|00005fe0| 6c 6c 6f 77 73 3a 20 0d | 73 68 6f 72 74 20 4d 79 |llows: .|short My|
|00005ff0| 43 6c 69 63 6b 41 63 74 | 69 6f 6e 28 73 68 6f 72 |ClickAct|ion(shor|
|00006000| 74 20 6d 54 79 70 65 2c | 20 44 69 61 6c 6f 67 50 |t mType,| DialogP|
|00006010| 74 72 20 64 6c 6f 67 2c | 20 73 68 6f 72 74 20 70 |tr dlog,| short p|
|00006020| 61 6e 65 2c 20 73 68 6f | 72 74 20 69 74 65 6d 29 |ane, sho|rt item)|
|00006030| 0d 54 68 65 20 6d 54 79 | 70 65 20 70 61 72 61 6d |.The mTy|pe param|
|00006040| 65 74 65 72 20 73 70 65 | 63 69 66 69 65 73 20 74 |eter spe|cifies t|
|00006050| 68 65 20 6d 65 73 73 61 | 67 65 20 74 6f 20 70 72 |he messa|ge to pr|
|00006060| 6f 63 65 73 73 20 77 68 | 65 6e 20 74 68 65 20 61 |ocess wh|en the a|
|00006070| 63 74 69 6f 6e 20 70 72 | 6f 63 65 64 75 72 65 20 |ction pr|ocedure |
|00006080| 69 73 20 63 61 6c 6c 65 | 64 2e 20 54 68 65 20 70 |is calle|d. The p|
|00006090| 72 6f 63 65 64 75 72 65 | 20 69 73 20 63 61 6c 6c |rocedure| is call|
|000060a0| 65 64 20 77 69 74 68 20 | 61 20 6b 49 6e 69 74 41 |ed with |a kInitA|
|000060b0| 63 74 69 6f 6e 20 6d 65 | 73 73 61 67 65 20 72 69 |ction me|ssage ri|
|000060c0| 67 68 74 20 61 66 74 65 | 72 20 74 68 65 20 63 6f |ght afte|r the co|
|000060d0| 6e 74 72 6f 6c 20 69 73 | 20 73 65 74 20 77 68 65 |ntrol is| set whe|
|000060e0| 6e 20 74 68 65 20 70 61 | 6e 65 20 69 73 20 66 69 |n the pa|ne is fi|
|000060f0| 72 73 74 20 64 69 73 70 | 6c 61 79 65 64 3b 20 74 |rst disp|layed; t|
|00006100| 68 69 73 20 67 69 76 65 | 73 20 79 6f 75 20 61 6e |his give|s you an|
|00006110| 20 6f 70 70 6f 72 74 75 | 6e 69 74 79 20 74 6f 20 | opportu|nity to |
|00006120| 73 65 74 20 75 70 20 74 | 68 65 20 69 6e 69 74 69 |set up t|he initi|
|00006130| 61 6c 20 73 74 61 74 65 | 20 6f 66 20 74 68 65 20 |al state| of the |
|00006140| 64 69 61 6c 6f 67 2e 20 | 54 68 65 20 70 72 6f 63 |dialog. |The proc|
|00006150| 65 64 75 72 65 20 69 73 | 20 63 61 6c 6c 65 64 20 |edure is| called |
|00006160| 77 69 74 68 20 61 20 6b | 43 6c 69 63 6b 41 63 74 |with a k|ClickAct|
|00006170| 69 6f 6e 20 6d 65 73 73 | 61 67 65 20 61 66 74 65 |ion mess|age afte|
|00006180| 72 20 74 68 65 20 75 73 | 65 72 20 68 61 73 20 72 |r the us|er has r|
|00006190| 65 6c 65 61 73 65 64 20 | 74 68 65 20 6d 6f 75 73 |eleased |the mous|
|000061a0| 65 20 62 75 74 74 6f 6e | 20 69 6e 20 61 20 63 6f |e button| in a co|
|000061b0| 6e 74 72 6f 6c 2e 20 41 | 20 6b 56 61 6c 69 64 61 |ntrol. A| kValida|
|000061c0| 74 65 41 63 74 69 6f 6e | 20 6d 65 73 73 61 67 65 |teAction| message|
|000061d0| 20 69 73 20 72 65 63 65 | 69 76 65 64 20 66 6f 72 | is rece|ived for|
|000061e0| 20 64 61 74 61 20 76 61 | 6c 69 64 61 74 69 6f 6e | data va|lidation|
|000061f0| 3b 20 69 74 d5 73 20 74 | 68 65 20 72 65 73 70 6f |; it.s t|he respo|
|00006200| 6e 73 69 62 69 6c 69 74 | 79 20 6f 66 20 74 68 65 |nsibilit|y of the|
|00006210| 20 43 6c 69 63 6b 20 61 | 63 74 69 6f 6e 20 70 72 | Click a|ction pr|
|00006220| 6f 63 65 64 75 72 65 20 | 74 6f 20 70 75 74 20 75 |ocedure |to put u|
|00006230| 70 20 61 6e 20 61 6c 65 | 72 74 20 74 6f 20 6e 6f |p an ale|rt to no|
|00006240| 74 69 66 79 20 74 68 65 | 20 75 73 65 72 20 69 66 |tify the| user if|
|00006250| 20 61 20 73 65 74 74 69 | 6e 67 20 69 73 20 75 6e | a setti|ng is un|
|00006260| 61 63 63 65 70 74 61 62 | 6c 65 2e 0d 4c 69 73 74 |acceptab|le..List|
|00006270| 69 6e 67 20 31 20 69 73 | 20 61 20 43 6c 69 63 6b |ing 1 is| a Click|
|00006280| 20 61 63 74 69 6f 6e 20 | 70 72 6f 63 65 64 75 72 | action |procedur|
|00006290| 65 20 66 72 6f 6d 20 74 | 68 65 20 73 61 6d 70 6c |e from t|he sampl|
|000062a0| 65 20 61 70 70 6c 69 63 | 61 74 69 6f 6e 20 74 68 |e applic|ation th|
|000062b0| 61 74 20 75 6e 64 69 6d | 73 20 74 68 65 20 74 68 |at undim|s the th|
|000062c0| 69 72 64 20 63 68 65 63 | 6b 62 6f 78 20 69 6e 20 |ird chec|kbox in |
|000062d0| 74 68 65 20 44 65 66 65 | 6e 73 65 20 70 61 6e 65 |the Defe|nse pane|
|000062e0| 20 69 66 20 74 68 65 20 | 73 65 63 6f 6e 64 20 63 | if the |second c|
|000062f0| 68 65 63 6b 62 6f 78 20 | 20 69 73 20 63 68 65 63 |heckbox | is chec|
|00006300| 6b 65 64 2e 20 49 74 20 | 61 6c 73 6f 20 0d 65 6e |ked. It |also .en|
|00006310| 73 75 72 65 73 20 74 68 | 61 74 20 74 68 65 20 65 |sures th|at the e|
|00006320| 64 69 74 61 62 6c 65 20 | 74 65 78 74 20 66 69 65 |ditable |text fie|
|00006330| 6c 64 20 69 6e 20 74 68 | 65 20 43 6f 6d 6d 75 6e |ld in th|e Commun|
|00006340| 69 63 61 74 69 6f 6e 73 | 20 70 61 6e 65 20 63 6f |ications| pane co|
|00006350| 6e 74 61 69 6e 73 20 6f | 6e 6c 79 20 64 69 67 69 |ntains o|nly digi|
|00006360| 74 73 3b 20 69 66 20 74 | 68 69 73 20 66 69 65 6c |ts; if t|his fiel|
|00006370| 64 20 63 6f 6e 74 61 69 | 6e 73 20 6e 6f 6e 64 69 |d contai|ns nondi|
|00006380| 67 69 74 73 2c 20 74 68 | 65 20 76 61 6c 69 64 61 |gits, th|e valida|
|00006390| 74 69 6f 6e 20 66 61 69 | 6c 73 20 61 6e 64 20 74 |tion fai|ls and t|
|000063a0| 68 65 20 75 73 65 72 20 | 63 61 6e d5 74 20 63 68 |he user |can.t ch|
|000063b0| 61 6e 67 65 20 70 61 6e | 65 73 20 6f 72 20 63 6c |ange pan|es or cl|
|000063c0| 69 63 6b 20 4f 4b 2e 0d | 4c 69 73 74 69 6e 67 20 |ick OK..|Listing |
|000063d0| 31 2e 20 41 20 73 61 6d | 70 6c 65 20 43 6c 69 63 |1. A sam|ple Clic|
|000063e0| 6b 20 61 63 74 69 6f 6e | 20 70 72 6f 63 65 64 75 |k action| procedu|
|000063f0| 72 65 0d 73 68 6f 72 74 | 20 4d 79 43 6c 69 63 6b |re.short| MyClick|
+--------+-------------------------+-------------------------+--------+--------+
Only 25.0 KB of data is shown above.
